关于腾讯位置服务不再支持HTTP方式调用的公告
为保证数据传输安全,提高安全性,腾讯位置服务WebServiceAPI将不再支持HTTP方式调用。
请开发者尽快调整,将现有通过HTTP方式调用的切换成 HTTPS 调用,以避免受到影响。 平台将于 2018年9月30日 停止对HTTP方式调用的支持。

概述

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

请求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 门牌,可能为空字串
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点

调用示例