/data/transform/coord
1.接口描述
该API的功能对 WGS-84（GPS 原始坐标）、GCJ-02（高德/腾讯地图坐标）、BD-09（百度地图坐标）三种坐标系之间的经纬度进行转换
请求方式：
POST
请求URL：
https://cloudapi.deepfinch.com/data/transform/coord
调试工具
2.请求参数
2.1 请求头域
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
| X-DF-API-ID | string | 是 | API调用凭证信息，详细信息请参考API调用 |
| X-DF-API-SECRET | string | 是 | API调用凭证信息，详细信息请参考API调用 |
2.2 请求体
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
| lng | int | 是 | 经度，取值范围：-180.0 ~ 180.0 |
| lat | int | 是 | 纬度，取值范围：-90.0 ~ 90.0 |
| from_system | string | 是 | 源坐标系，取值范围：见2.2.1坐标系说明 |
| to_system | string | 是 | 目标坐标系取值范围：见2.2.1坐标系说明 |
2.2.1 坐标系说明
| 坐标系 | 说明 | 典型使用场景 |
|---|---|---|
WGS-84 |
国际标准地球坐标系 | GPS 设备、Google 地图（海外）、原始定位数据 |
GCJ-02 |
国家测绘局坐标系（火星坐标系） | 高德地图、腾讯地图、Google 地图（中国） |
BD-09 |
百度坐标系 | 百度地图（在 GCJ-02 基础上二次加密） |
为什么要转换？
中国法规要求电子地图必须使用加密坐标系。如果直接将 GPS 设备采集的 WGS-84 坐标用于高德地图，会产生 300~600 米 的偏移。
3.返回参数
正常响应 （200）
| 字段 | 类型 | 描述 |
|---|---|---|
| request_id | string | 本次请求的 id |
| status | string | 状态。正常为 OK ，其他值表示失败。详见详见错误码 |
| result | object | 查询结果 |
其中result的字段如下：
| 字段 | 类型 | 描述 |
|---|---|---|
| lng | int | 转换后经度，保留 6 位小数 |
| lat | int | 转换后纬度，保留 6 位小数 |
| system | string | 转换后的坐标系 |
输出示例：
{
"request_id": "TID7a71dd79c3ba4562b757a5501b39dec5",
"status": "OK",
"result": {
"lng": 116.403672,
"lat": 39.910608,
"system": "GCJ-02"
}
}
4.错误码
| 状态码 | status 字段 |
说明 |
|---|---|---|
400 |
INVALID_ARGUMENT | 请求参数错误 |
401 |
UNAUTHORIZED | 未授权或授权失败 |
403 |
RATE_LIMIT_EXCEEDED | 调用频率超出限额 |
404 |
NOT_FOUND | 请求路径错误 |
500 |
INTERNAL_ERROR | 服务器内部错误 |
输出示例：
{
"status": "RATE_LIMIT_EXCEEDED",
"request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}