概述

本接口提供由地址描述到所述位置坐标的转换,与逆地址解析的过程正好相反。

请求URL

该请求为GET请求

http://apis.map.qq.com/ws/geocoder/v1/?address=

请求参数

参数 必填 说明 示例
address 地址(注:地址中请包含城市名称,否则会影响解析效果) address=北京市海淀区彩和坊路海淀西大街74号
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 门牌,可能为空字串
similarity number 查询字符串与查询结果的文本相似度
deviation number 误差距离,单位:米, 该值取决于输入地址的精确度;
如address输入:海淀区北四环西路,因为地址所述范围比较大,因此会有千米级误差;
而如:银科大厦这类具体的地址,返回的坐标就会相对精确;
该值为 -1 时,说明输入地址为过于模糊,仅能精确到市区级。
reliability number 可信度参考:值范围 1 <低可信> - 10 <高可信>
我们根据用户输入地址的准确程度,在解析过程中,将解析结果的可信度(质量),由低到高,分为1 - 10级,该值>=7时,解析结果较为准确,<7时,会存各类不可靠因素,开发者可根据自己的实际使用场景,对于解析质量的实际要求,进行参考。

调用示例