高精度經緯度查詢是指對用戶輸入的地址信息,返回用戶地址所對應的高精度空間經緯度坐標的結果,默認支持高德坐標系,返回結果上一般可以精細到樓棟級別,相比通用經緯度精細度更高,適合需要高精度場景下空間服務。
測試
您可以在地址標準化產品控制臺進行API測試。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
Action | String | 是 | HpGeocode | 系統規定參數。取值: HpGeocode |
AppKey | String | 是 | Axqwerasdf1a | 項目AppKey |
ServiceCode | String | 是 | addrp | 固定值:addrp |
Text | String | 是 | 杭州市阿里巴巴西溪a區 | 文本內容 |
DefaultProvince | String | 否 | 浙江省 | 默認省份 |
DefaultCity | String | 否 | 杭州市 | 默認城市 |
DefaultDistrict | String | 否 | 余杭區 | 默認行政區 |
返回數據
名稱 | 類型 | 示例值 | 描述 |
Data | String | { "hpgeocode":{ "level":"subpoi", "gcj02":"120.025746,30.278984"}, "status":"OK", "time_used":{"rt":{"hpgeocode":0.4139995574951172}, "start":1675070463.4350975}} | hpgeocode:高精度經緯度查詢(樓棟級別)結果 level:精度層級 gcj02:gcj02坐標系經緯度 time_used:算法處理耗時 status:狀態 |
RequestId | String | 3A9AB010-AC38-4E53-9D25-6B97238C2897 | RequestId |
示例
請求示例
http(s)://[Endpoint]/?Action=HpGeocode
&AppKey=Axqwerasdf1a
&ServiceCode=addrp
&Text=杭州市阿里巴巴西溪a區
&<公共請求參數>
正常返回示例
XML格式
<RequestId>226BD68D-6208-4140-A6EC-2F2BF434B601</RequestId>
<Data>
<hpgeocode>
<level>subpoi</level>
<gcj02>120.025746,30.278984</gcj02>
</hpgeocode>
<status>OK</status>
<time_used>
<rt>
<hpgeocode>0.4139995574951172</hpgeocode>
</rt>
<start>1675070463.4350975</start>
</time_used>
</Data>
JSON格式
{
"RequestId": "226BD68D-6208-4140-A6EC-2F2BF434B601",
"Data": {
"hpgeocode":{
"level":"subpoi",
"gcj02":"120.025746,30.278984"
},
"status":"OK",
"time_used":{
"rt":{
"hpgeocode":0.4139995574951172
},
"start":1675070463.4350975
}
}
}
錯誤碼
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. | 用戶狀態無效 |
訪問錯誤中心查看更多錯誤碼。