地理坐标系转换

经纬度顺序为经度在前、纬度在后。支持现有三种坐标系及已经有效的坐标和 GeoJSON 表达，结果字段保持字符串；不提供地址解析或反地理编码，也不作为测绘精度保证。
在 WGS84、GCJ02 与 BD09 三种坐标系之间转换。
将 WGS84 点位整理为 GCJ02 地图坐标。
将 GCJ02 点位转换为 WGS84 表达。
在 GCJ02 与 BD09 之间转换地图点位。
将 BD09 点位整理为 WGS84 坐标。
支持经度在前、纬度在后的十进制坐标输入。
保留已经有效的数字字符串坐标表达。
保留已有有效 GeoJSON 地理对象转换能力。
同时返回原坐标系和目标坐标系，便于核对。
原始坐标与目标结果分别返回，便于对照整理。
可用于网点、门店及地图标注资料转换。
可在地图资料迁移时整理不同来源的点位。

当前接口契约

接口详情：https://www.gugudata.com/api/details/coordinateconverter

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	使用已授权的 APPKEY，兼容现有有效鉴权位置。此鉴权位置可选；整体鉴权要求及其他已支持位置以本操作说明为准。
from	string	是	无	输入坐标系：WGS84、GCJ02 或 BD09，保留已有大小写兼容。
to	string	是	无	目标坐标系：WGS84、GCJ02 或 BD09。
value	string	是	无	坐标 JSON 字符串，基本形式为 [经度,纬度]；保留已有有效数字字符串及 GeoJSON 表达。

正常响应字段

字段	类型	说明
DataStatus.RequestParameter	string	实际、可读业务请求参数，不包含凭据。
DataStatus.StatusCode	integer	成功为 100；参数错误为 501；处理或依赖失败为 901。
DataStatus.StatusDescription	string	业务状态说明。
DataStatus.ResponseDateTime	string	接口返回时间。
DataStatus.DataTotalCount	integer	实际结果数量。
Data	object	数据结果。
Data.CoordinateFrom	string	输入坐标系，保留正常输入回显格式。
Data.CoordinateTo	string	目标坐标系。
Data.CoordinateSourceValue	string	实际输入坐标字符串。
Data.CoordinateDestinationValue	string	转换后的坐标 JSON 字符串，保留现有算法精度。

业务状态说明

业务状态码	业务状态码解释	备注
100	成功	HTTP 200
501	参数错误	HTTP 400
901	处理、依赖失败或超时	HTTP 503
502	请求频率限制	HTTP 429
503	权益过期	HTTP 403
504	凭据无效或无权限	HTTP 401
505	调用额度不足	HTTP 403

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功（业务码 100）。

Bodyapplication/json

示例

{"DataStatus":{"StatusCode":100,"RequestParameter":"from=WGS84&to=BD09&value=[120.54,32.74]","StatusDescription":"请求成功。","ResponseDateTime":"2026-10-23 15:06:19.784","DataTotalCount":1},"Data":{"CoordinateFrom":"WGS84","CoordinateTo":"BD09","CoordinateSourceValue":"[120.54,32.74]","CoordinateDestinationValue":"[120.55097157278423,32.74358962248261]"}}

🟠400参数错误（业务码 501）。

🔴503处理、依赖失败或超时（业务码 901）。

🟠429请求频率限制（业务码 502）。

🟠403权益过期（业务码 503）；调用额度不足（业务码 505）。

🟠401凭据无效或无权限（业务码 504）。

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明