概述

本接口提供由坐标到坐标所在位置的文字描述的转换。输入坐标返回地理位置信息和附近poi列表。目前应用于O2O、出行、社交等场景。服务响应速度快、稳定,支撑亿级调用。
     1)满足传统对省市区、乡镇村、门牌号、道路及交叉口、河流、湖泊、桥、poi列表的需求。
     2)业界首创,提供易于人理解的地址描述:如海淀区海淀桥东中国技术交易大厦内(彩和坊路东)。
     3)提供精准的商圈、知名的大型区域、附近知名的一级地标、代表当前位置的二级地标等。

请求URL

该请求为GET请求

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

请求参数

参数 必填 说明 示例
location 位置坐标,格式:
location=lat<纬度>,lng<经度>
location= 39.984154,116.307490
coord_type 输入的locations的坐标类型
可选值为[1,6]之间的整数,每个数字代表的类型说明:
1 GPS坐标
2 sogou经纬度
3 baidu经纬度
4 mapbar经纬度
5 [默认]腾讯、google、高德坐标
6 sogou墨卡托
coord_type=3
get_poi 是否返回周边POI列表:
1.返回;0不返回(默认)
get_poi=1
poi_options 用于控制Poi列表:
1 poi_options=address_format=short
返回短地址,缺省时返回长地址
2 poi_options=radius=5000
半径,取值范围 1-5000(米)
3 poi_options=page_size=20
每页条数,取值范围 1-20
4 poi_options=page_index=1
页码,取值范围 1-20
5 poi_options=policy=1/2/3
控制返回场景,
policy=1[默认] 以地标+主要的路+近距离POI为主,着力描述当前位置;
policy=2 到家场景:筛选合适收货的POI,并会细化收货地址,精确到楼栋;
policy=3 出行场景:过滤掉车辆不易到达的POI(如一些景区内POI),增加道路出路口、交叉口、大区域出入口类POI,排序会根据真实API大用户的用户点击自动优化。
6 poi_options=category=分类词1,分类词2,
指定分类,多关键词英文逗号分隔;
poi_filter=category<>分类词1,分类词2,
指定不包含分类,多关键词英文逗号分隔
(支持类别参见:附录)
【单个参数写法示例】:
poi_options=address_format=short
【多个参数英文分号间隔,写法示例】:
poi_options=address_format=short;radius=5000;
page_size=20;page_index=1;policy=2
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 逆地址解析结果
address string 地址描述
formatted_addresses object 位置描述
recommend string 经过腾讯地图优化过的描述方式,更具人性化特点
rough string 大致位置,可用于对位置的粗略描述
address_component object 地址部件,address不满足需求时可自行拼接
nation string 国家
province string
city string
district string 区,可能为空字串
street string 街道,可能为空字串
street_number string 门牌,可能为空字串
ad_info object 行政区划信息
adcode string 行政区划代码
name string 行政区划名称
location object 行政区划中心点坐标
lat number 纬度
lng number 经度
nation string 国家
province string 省 / 直辖市
city string 市 / 地级区 及同级行政区划
district string 区 / 县级市 及同级行政区划
address_reference object 坐标相对位置参考
famous_area object 知名区域,如商圈或人们普遍认为有较高知名度的区域
title string 名称/标题
location object 坐标
lat number 纬度
lng number 经度
_distance number 此参考位置到输入坐标的直线距离
_dir_desc string 此参考位置到输入坐标的方位关系,如:北、南、内
town object 乡镇街道
title string 名称/标题
location objct 坐标
lat number 纬度
lng number 经度
_distance number 此参考位置到输入坐标的直线距离
_dir_desc string 此参考位置到输入坐标的方位关系,如:北、南、内
landmark_l1 object 一级地标,可识别性较强、规模较大的地点、小区等
【注】对象结构同 famous_area
landmark_l2 object 二级地标,较一级地标更为精确,规模更小
【注】:对象结构同 famous_area
street object 街道    【注】:对象结构同 famous_area
street_number object 门牌    【注】:对象结构同 famous_area
crossroad object 交叉路口    【注】:对象结构同 famous_area
water object 水系    【注】:对象结构同 famous_area
pois array POI数组,对象中每个子项为一个POI对象
id string POI唯一标识
title string POI名称
address string 地址
category string POI分类
location object 提示所述位置坐标
lat number 纬度
lng number 经度
_distance number 该POI到逆地址解析传入的坐标的直线距离

调用示例

//GET请求示例,注意参数值要进行URL编码
http://apis.map.qq.com/ws/geocoder/v1/?location=39.984154,116.307490&key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77&get_poi=1
在线测试


location  点击地图,获取坐标值
get_poi
key


我要说两句