概述

    本接口提供由经纬度到文字地址及相关位置信息的转换能力,广泛应用于物流、出行、O2O、社交等场景。服务响应速度快、稳定,支撑亿级调用。

    1)满足传统对省市区、乡镇村、门牌号、道路及交叉口、河流、湖泊、桥、poi列表的需求。

    2)提供通过知名地点、地标组合形成的易于理解的地址,如:北京市海淀区中钢国际广场(欧美汇购物中心北)。

    3)提供精准的商圈、知名的大型区域、附近知名的一级地标、代表当前位置的二级地标等。


请求URL

    该请求为GET请求

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

请求参数

参数 必填 说明 示例
location 经纬度(GCJ02坐标系),格式:
location=lat<纬度>,lng<经度>
location= 39.984154,116.307490
get_poi 是否返回周边地点(POI)列表,可选值:
0 不返回(默认)
1 返回
get_poi=1
poi_options 周边POI列表控制参数:
1 poi_options=address_format=short
返回短地址,缺省时返回长地址
2 poi_options=radius=5000
半径,取值范围 1-5000(米)
3 poi_options=policy=1/2/3/4/5
控制返回场景,
policy=1[默认] 以地标+主要的路+近距离POI为主,着力描述当前位置;
policy=2 到家场景:筛选合适收货的POI,并会细化收货地址,精确到楼栋;
policy=3 出行场景:过滤掉车辆不易到达的POI(如一些景区内POI),增加道路出入口、交叉口、大区域出入口类POI,排序会根据真实API大用户的用户点击自动优化。
policy=4 社交签到场景,针对用户签到的热门 地点进行优先排序。
policy=5 位置共享场景,用户经常用于发送位置、位置分享等场景的热门地点优先排序
4 注:本接口最多返回10条周边POI,如需更多请参见地点搜索-周边推荐
【单个参数写法示例】:
poi_options=address_format=short
【多个参数英文分号间隔,写法示例】:
poi_options=address_format=short;radius=5000;policy=2
key 开发密钥(Key) key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-WPB77
output 返回格式:支持JSON/JSONP,默认JSON output=json
callback JSONP方式回调函数 callback=function1

响应结果

名称 类型 必填 说明
status number 状态码,0为正常,其它为异常,详细请参阅状态码说明
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 国家代码(ISO3166标准3位数字码)
adcode string 行政区划代码,规则详见:行政区划代码说明
city_code string 城市代码,由国家码+行政区划代码(提出城市级别)组合而来,总共为9位
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 此参考位置到输入坐标的方位关系,如:北、南、内
business_area object 商圈,目前与famous_area一致
town object 乡镇街道
id string 地点唯一标识
title string 名称/标题
location object 坐标
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的总数,仅在传入参数get_poi=1时返回
pois array 周边地点(POI)数组,数组中每个子项为一个POI对象
id string 地点(POI)唯一标识
title string 名称
address string 地址
category string 地点分类信息
location object 提示所述位置坐标
lat number 纬度
lng number 经度
ad_info object 行政区划信息
adcode number 行政区划代码
province string
city string
district string
_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

在线测试


这篇文章对您解决问题是否有帮助?

已解决
未解决