概述

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

        

请求URL

该请求为GET请求

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

请求参数

参数 必填 说明 示例
location 是 位置坐标，格式：
location=lat<纬度>,lng<经度>		 location= 39.984154,116.307490
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
注：分页时page_size与page_index参数需要同时使用
5 poi_options=policy=1/2/3/4/5
控制返回场景，
policy=1[默认] 以地标+主要的路+近距离POI为主，着力描述当前位置；
policy=2 到家场景：筛选合适收货的POI，并会细化收货地址，精确到楼栋；
policy=3 出行场景：过滤掉车辆不易到达的POI(如一些景区内POI)，增加道路出入口、交叉口、大区域出入口类POI，排序会根据真实API大用户的用户点击自动优化。
policy=4 社交签到场景，针对用户签到的热门地点进行优先排序。
policy=5 位置共享场景，用户经常用于发送位置、位置分享等场景的热门地点优先排序
6 poi_options=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 是 状态说明
request_id 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 是 行政区划信息
nation_code string 是 国家代码
adcode string 是 行政区划代码
name string 是 行政区划名称
location object 是 行政区划中心点坐标
lat number 是 纬度
lng number 是 经度
nation string 是 国家
province string 是 省 / 直辖市
city string 是 市 / 地级区 及同级行政区划
district string 否 区 / 县级市 及同级行政区划
address_reference object 否 坐标相对位置参考
famous_area object 否 知名区域，如商圈或人们普遍认为有较高知名度的区域
id string 是 地点唯一标识
title string 否 名称/标题
location object 否 坐标
lat number 否 纬度
lng number 否 经度
_distance number 否 此参考位置到输入坐标的直线距离
_dir_desc string 否 此参考位置到输入坐标的方位关系，如：北、南、内
town object 否 乡镇街道
id string 是 地点唯一标识
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
poi_count number 查询的周边poi的总数
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编码
https://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


我要说两句