高精度经纬度查询是指对用户输入的地址信息,返回用户地址所对应的高精度空间经纬度坐标的结果,默认支持高德坐标系,返回结果上一般可以精细到楼栋级别,相比通用经纬度精细度更高,适合需要高精度场景下空间服务。
测试
您可以在地址标准化产品控制台进行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. | 用户状态无效 |
访问错误中心查看更多错误码。