对输入的指定坐标系的经纬度坐标进行其他坐标系转换;目前支持的坐标系包括:GCJ02、WGS84、CGCS2000、BD09。
测试
您可以在地址标准化产品控制台进行API测试。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
Action | String | 是 | TransferCoord | 系统规定参数。取值:TransferCoord。 |
AppKey | String | 是 | Axqwerasdf1a | 项目AppKey |
ServiceCode | String | 是 | addrp | 固定值:addrp |
Text | String | 是 | 120.026268,30.279164 | 输入为“,”号分割的经度坐标和纬度坐标,坐标值必须是一个数字 |
SrcCoord | String | 是 | gcj02 | 输入经纬度的坐标系名称,目前支持:gcj02、wgs84、cgcs2000、bd09 |
DefaultProvince | String | 否 | 浙江省 | 默认省份 |
DefaultCity | String | 否 | 杭州市 | 默认城市 |
DefaultDistrict | String | 否 | 余杭区 | 默认行政区 |
返回数据
名称 | 类型 | 示例值 | 描述 |
Data | String | {"coord_transfer":{"BD09":"120.032768,30.285238","CGCS2000":"120.021519,30.281543","WGS84":"120.021519,30.281543","GCJ02":"120.026268,30.279164"},"status":"OK","time_used":{"rt":{"coord_transfer":0.00026416778564453125},"start":1619320226.3847773}} | coord_transfer:坐标系转换结果 time_used:算法处理耗时 status:状态 |
RequestId | String | E0627DDE-28D7-4C00-A611-E047DF81AF05 | RequestId |
示例
请求示例
http(s)://[Endpoint]/?Action=TransferCoord
&AppKey=Axqwerasdf1a
&ServiceCode=addrp
&Text=120.026268,30.279164
&SrcCoord=gcj02
&<公共请求参数>
正常返回示例
XML格式
<RequestId>0C95C4A0-0C40-40FF-B342-EDABCB90704E</RequestId>
<Data>
<coord_transfer>
<BD09>120.032768,30.285238</BD09>
<CGCS2000>120.021519,30.281543</CGCS2000>
<WGS84>120.021519,30.281543</WGS84>
<GCJ02>120.026268,30.279164</GCJ02>
</coord_transfer>
<status>OK</status>
<time_used>
<rt>
<coord_transfer>0.00026416778564453125</coord_transfer>
</rt>
<start>1619320226.3847773</start>
</time_used>
</Data>
JSON格式
{
"RequestId": "0C95C4A0-0C40-40FF-B342-EDABCB90704E",
"Data": {
"coord_transfer": {
"BD09": "120.032768,30.285238",
"CGCS2000": "120.021519,30.281543",
"WGS84": "120.021519,30.281543 ",
"GCJ02 ": "120.026268,30.279164 "
},
"status ": "OK ",
"time_used ": {
"rt ": {
"coord_transfer": 0.00026416778564453125
},
"start": 1619320226.3847773
}
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
403 | Forbidden.NoAuth | Failed to perform user authentication. | 用户鉴权失败 |
500 | InternalError | A service error occurred. | 服务内部异常 |
400 | InvalidParameter | The parameter is invalid. | 参数无效 |
404 | ResourceDoesNotExist | The resource does not exist. | 资源不存在 |
429 | Throttling.User | Flow control has been triggered. | 触发流控 |
400 | UserStatusInvalid | The user status is invalid. | 用户状态无效 |
访问错误中心查看更多错误码。