正在跳转至目标页,请稍后…
概述
本接口提供由文字地址到经纬度的转换能力,并同时提供结构化的省市区地址信息。
|
请求URL
该请求为GET请求
https://apis.map.qq.com/ws/geocoder/v1/?address=
请求参数
参数 |
必填 |
说明 |
示例 |
key |
是 |
开发密钥(Key) |
key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-***** |
address |
是 |
地址(注:结构化地址,地址中需包含省市区信息,以及需要对地址进行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(解析级别)取值表:
值 |
解析级别 |
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=[你的key]
在线测试