Geographic Coordinate System Converter

Geographic Coordinate System Converter
Convert geographic coordinates between WGS84, GCJ02, and BD09 using the service's current upstream conversion contract.

Method: GET
Path: /v1/location/coordinateconverter
Demo: https://api.gugudata.io/v1/location/coordinateconverter/demo
OpenAPI: https://gugudata.io/assets/openapi/gugudata.openapi.3.1.json

Request Parameters:

• appkey (string, required): Application key used for request authentication. Supply the value as a query parameter, form field, or multipart field according to the request content type.
• from (string, required): Source coordinate system. Supported values are WGS84, GCJ02, and BD09.
• to (string, required): Target coordinate system. Supported values are WGS84, GCJ02, and BD09.
• value (string, required): Coordinate pair in [longitude,latitude] format, for example [120.54,32.74].

Response Fields:

• dataStatus (object, required): Response metadata. dataStatus.statusCode is a response body status field, not the HTTP status code.
• dataStatus.requestParameter (string, required): Normalized request parameters echoed by the service. Sensitive credentials are omitted when available.
• dataStatus.statusCode (integer, required): Response body status field. Successful demo responses currently return 100.
• dataStatus.statusDescription (string, required): Response body status message. Successful demo responses currently return a Chinese message.
• dataStatus.responseDateTime (string, required): Response timestamp returned by the current service contract.
• dataStatus.dataTotalCount (integer, required): Total number of records that match the request.
• data (object, required): Primary response payload returned by the endpoint.
• data.coordinateFrom (string, required): Source coordinate system (WGS84, GCJ02, or BD09)
• data.coordinateTo (string, required): Target coordinate system (WGS84, GCJ02, or BD09)
• data.coordinateSourceValue (string, required): Source coordinate value in format [longitude,latitude]
• data.coordinateDestinationValue (string, required): Converted coordinate value in format [longitude,latitude]

HTTP Status Codes:

• 200: Request processed successfully. Some endpoints expose a separate application-level status field in the response body, such as dataStatus.statusCode.
• 400: Invalid request parameters or request format. Check required fields, data types, and request body format.
• 401: Missing or unknown application key. Provide a valid appkey with the request.
• 403: The application key is recognized but access is not allowed. The key may be expired, inactive, or not permitted for the requested API.
• 429: Request rate or trial usage limit exceeded. Reduce concurrency or retry after the limit window resets.
• 500: Internal service error. Retry later or contact support if the error persists.
• 503: Upstream service unavailable. Retry later; the requested upstream dependency is temporarily unavailable.

Business Status Codes:

• 100 Normal return: Request successful, coordinate conversion completed
• -1 Request failed: Request processing failed
• 501 Parameter error: Invalid parameters or parameter type mismatch. Please check parameter count and types. Ensure from/to are valid coordinate systems (WGS84, GCJ02, BD09) and value is in format [longitude,latitude]
• 429 Request frequency limited: Recommended QPS <= 5 per IP. Excessive requests may trigger rate limiting
• 502 Request frequency limited: Same IP excessive requests or detected as malicious data scraping
• 503 APPKEY permission exceeded/order expired: Please check your APPKEY status in developer center
• 504 APPKEY error: Please verify the APPKEY is obtained from developer center
• 505 Request count exceeded: Check API request limit and remaining quota
• 900 Internal API error: Service availability (SLA) is 99.8824%. Contact support if this occurs

Key Features:

• Support multiple geographic coordinate systems (WGS84, GCJ02, BD09).
• High-precision coordinate conversion algorithms.
• Bidirectional conversion between WGS84, GCJ02, and BD09 coordinate systems.
• Simple coordinate format: [longitude,latitude].
• Fast conversion response with millisecond-level performance.
• Perfect for map applications, GPS navigation, and location-based services.
• Full API support for HTTPS (TLS v1.0 / v1.1 / v1.2 / v1.3).
• Fully compatible with Apple ATS.
• Nationwide multi-node CDN deployment.
• Ultra-fast response, API interface load balancing built with multiple servers.

Details:
https://gugudata.io/details/coordinateconverter