概述
本接口提供由文字地址到经纬度的转换能力,并同时提供结构化的省市区地址信息。
|
请求URL
该请求为GET请求
请求参数
参数 | 必填 | 说明 | 示例 |
---|---|---|---|
key | 是 | 开发密钥(Key) | key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-***** |
address | 是 | 要解析获取坐标及相关信息的 输入地址,参数要求: 1. 为提升解析准确率,地址中请至少包含城市名称,否则将视为参数错误,同时地址请尽量完整、具体(包括省市区乡镇/街道门牌及详细地点信息) 2. 需要对地址进行URL编码,否则若包含"#"等一些功能字符将引起错误 |
address=北京市海淀区彩和坊路海淀西大街74号 注意:URL编码仅对传入的地址信息(北京市海淀区彩和坊路海淀西大街74号)进行编码 |
output | 否 | 返回格式:支持JSON/JSONP,默认JSON | output=json |
callback | 否 | JSONP方式回调函数 | callback=function1 |
响应结果
名称 | 类型 | 必有 | 说明 | ||
---|---|---|---|---|---|
status | number | 是 | 状态码,0为正常,其它为异常,详细请参阅状态码说明 | ||
message | string | 是 | 状态说明 | ||
result | object | 是 | 地址解析结果 | ||
title | string | 是 | [废弃]最终用于坐标解析的地址或地点名称(仅供参考,不建议实际使用) (如果需要获得结构化及标准化地址请参阅 智能地址解析) |
||
location | object | 是 | 解析到的坐标(GCJ02坐标系) | ||
lat | number | 是 | 纬度 | ||
lng | number | 是 | 经度 | ||
address_components | object | 是 | 解析后的地址部件 | ||
province | string | 是 | 省 | ||
city | string | 是 | 市,如果当前城市为省直辖县级区划,city与district字段均会返回此城市 注:省直辖县级区划adcode第3和第4位分别为9、0,如济源市adcode为419001 |
||
district | string | 是 | 区,可能为空字串 | ||
street | string | 是 | 街道/道路,可能为空字串 (要获取行政区划的街道级别请参阅 智能地址解析) |
||
street_number | string | 是 | 门牌,可能为空字串 | ||
ad_info | object | 是 | 行政区划信息 | ||
adcode | string | 是 | 行政区划代码,规则详见:行政区划代码说明 | ||
similarity | number | 是 | 即将下线,由reliability代替 | ||
deviation | number | 是 | 即将下线,由level代替 | ||
reliability | number | 是 | 可信度参考:值范围 1 <低可信> - 10 <高可信> 我们根据用户输入地址的准确程度,在解析过程中,将解析结果的可信度(质量),由低到高,分为1 - 10级,该值>=7时,解析结果较为准确,<7时,会存各类不可靠因素,开发者可根据自己的实际使用场景,对于解析质量的实际要求,进行参考。 |
||
level | number | 否 | 解析精度级别,分为11个级别,一般>=9即可采用(定位到点,精度较高) 也可根据实际业务需求自行调整,完整取值表见下文。 |
level(解析级别)取值表:
值 | 解析级别 |
---|---|
0 | 无法判别,结果不可信 |
1 | 城市 |
2 | 区、县 |
3 | 乡镇、街道 |
4 | 村、社区 |
5 | 开发区 |
6 | 热点区域、商圈 |
7 | 道路 |
8 | 道路附属点:交叉口、收费站、出入口等 |
9 | 门址 |
10 | 小区、大厦 |
11 | POI点 |
21及以上 | 等同于POI点 |
调用示例
//GET请求示例,注意参数值要进行URL编码
https://apis.map.qq.com/ws/geocoder/v1/?address=北京市海淀区彩和坊路海淀西大街74号&key=[你的key]
这篇文章对您解决问题是否有帮助?
已解决
未解决