概述
本接口提供由地址描述到所述位置坐标的转换,与逆地址解析的过程正好相反。
请求URL
该请求为GET请求
https://apis.map.qq.com/ws/geocoder/v1/?address=
请求参数
参数 | 必填 | 说明 | 示例 |
---|---|---|---|
address | 是 | 地址(注:地址中请包含城市名称,否则会影响解析效果) | address=北京市海淀区彩和坊路海淀西大街74号 |
region | 否 | 指定地址所属城市 | region=北京 |
key | 是 | 开发密钥(Key) | key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77 |
output | 否 | 返回格式:支持JSON/JSONP,默认JSON | output=json |
callback | 否 | JSONP方式回调函数 | callback=function1 |
响应结果
名称 | 类型 | 必填 | 说明 | ||
---|---|---|---|---|---|
status | number | 是 | 状态码,0为正常 310请求参数信息有误 311Key格式错误 306请求有护持信息请检查字符串 110请求来源未被授权 |
||
message | string | 是 | 状态说明 | ||
result | object | 是 | 地址解析结果 | ||
location | string | 是 | 解析到的坐标 | ||
lat | number | 是 | 纬度 | ||
lng | number | 是 | 经度 | ||
address_components | object | 是 | 解析后的地址部件 | ||
province | string | 是 | 省 | ||
city | string | 是 | 市 | ||
district | string | 是 | 区,可能为空字串 | ||
street | string | 是 | 街道,可能为空字串 | ||
street_number | string | 是 | 门牌,可能为空字串 | ||
ad_info | object | 是 | 行政区划信息 | ||
adcode | 行政区划代码 | ||||
similarity | number | 是 | 即将下线,由reliability代替 | ||
deviation | number | 是 | 即将下线,由level代替 | ||
reliability | number | 是 | 可信度参考:值范围 1
<低可信> - 10
<高可信> 我们根据用户输入地址的准确程度,在解析过程中,将解析结果的可信度(质量),由低到高,分为1 - 10级,该值>=7时,解析结果较为准确,<7时,会存各类不可靠因素,开发者可根据自己的实际使用场景,对于解析质量的实际要求,进行参考。 |
||
level | number | 否 | 解析精度级别,分为11个级别,一般>=9即可采用(定位到点,精度较高) 也可根据实际业务需求自行调整,完整取值表见下文。 |
level(解析级别)取值表:
值 | 解析级别 |
---|---|
1 | 城市 |
2 | 区、县 |
3 | 乡镇、街道 |
4 | 村、社区 |
5 | 开发区 |
6 | 热点区域、商圈 |
7 | 道路 |
8 | 道路附属点:交叉口、收费站、出入口等 |
9 | 门址 |
10 | 小区、大厦 |
11 | POI点 |
调用示例
//GET请求示例,注意参数值要进行URL编码
在线测试
我要说两句
https://apis.map.qq.com/ws/geocoder/v1/?address=北京市海淀区彩和坊路海淀西大街74号&key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77 |
address | |
key |