對輸入的指定坐標系的經緯度坐標進行其他坐標系轉換;目前支持的坐標系包括: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. | 用戶狀態無效 |
訪問錯誤中心查看更多錯誤碼。