正在跳转至目标页，请稍后…
概述
本接口提供由经纬度到文字地址及相关位置信息的转换能力，广泛应用于物流、出行、O2O、社交等场景。服务响应速度快、稳定，支撑亿级调用。
支持根据输入经纬度，获取：
1 . 经纬度所在省、市、区、乡镇、门牌号、行政区划代码，及周边参考位置信息，如道路及交叉口、河流、湖泊、桥等
2 . 通过知名地点、地标组合形成的易于理解的地址，如：北京市海淀区中钢国际广场(欧美汇购物中心北)。
3 . 商圈、附近知名的一级地标、代表当前位置的二级地标等。
4 . 周边POI（AOI）列表。
请求URL
该请求为GET请求
请求参数
| 参数 | 必填 | 说明 | 示例 |
|---|---|---|---|
| key | 是 | 开发密钥（Key） | key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-***** |
| location | 是 | 经纬度（GCJ02坐标系），格式： location=lat<纬度>,lng<经度> |
location= 39.984154,116.307490 |
| get_poi | 否 | 是否返回周边地点（POI）列表，可选值： 0 不返回(默认) 1 返回 |
get_poi=1 |
| poi_options | 否 | 周边POI（AOI）列表控制参数： 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 注：policy=1/2/3最多返回10条周边POI，policy=4/5最多返回20条， 如需更多请参见地点搜索-周边推荐 |
【单个参数写法示例】： poi_options=address_format=short 【多个参数英文分号间隔，写法示例】： poi_options=address_format=short;radius=5000;policy=2 |
| 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 | 是 | 市，如果当前城市为省直辖县级区划，city与district字段均会返回此城市 注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001 |
||||
| district | string | 否 | 区，可能为空字串 | ||||
| street | string | 否 | 道路，可能为空字串 | ||||
| street_number | string | 否 | 门牌，可能为空字串 | ||||
| ad_info | object | 是 | 行政区划信息 | ||||
| nation_code | string | 是 | 国家代码（ISO3166标准3位数字码） | ||||
| adcode | string | 是 | 行政区划代码，规则详见：行政区划代码说明 | ||||
| city_code | string | 是 | 城市代码，由国家码+行政区划代码（提出城市级别）组合而来，总共为9位 | ||||
| phone_area_code | string | 否 | 城市电话区号 | ||||
| name | string | 是 | 行政区划名称 | ||||
| location | object | 是 | 行政区划中心点坐标 | ||||
| lat | number | 是 | 纬度 | ||||
| lng | number | 是 | 经度 | ||||
| nation | string | 是 | 国家 | ||||
| province | string | 是 | 省 / 直辖市 | ||||
| city | string | 是 | 市 / 地级区 及同级行政区划，如果当前城市为省直辖县级区划，city与district字段均会返回此城市 注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001 |
||||
| 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 | 是 | 乡镇/街道唯一标识（行政区划代码adcode） | ||||
| 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 | ||||
| ocean | object | 否 | 海洋信息 | ||||
| id | string | 否 | 海洋唯一标识 | ||||
| title | string | 否 | 海洋名称 | ||||
| poi_count | number | 查询的周边poi的总数，仅在传入参数get_poi=1时返回 | |||||
| pois | array | 否 | 周边地点（POI/AOI）列表，数组中每个子项为一个POI/AOI对象 说明：POI即地点，如一个便利店，往往因其面积较小，其位置一般仅会标为为一个点，而学校、小区等往往面积较大，通常会有一定的地理范围，即所谓AOI，如果所请求的经纬度在AOI内，其距离会为0，且方位描述为“内”，如果是一个面积较小的地点，或不在AOI内，距离会>0，方位描述会为具体方位词，如“东” |
||||
| id | string | 否 | 地点（POI）唯一标识 | ||||
| title | string | 否 | 名称 | ||||
| address | string | 否 | 地址 | ||||
| category | string | 否 | 地点分类信息 | ||||
| location | object | 否 | 提示所述位置坐标 | ||||
| lat | number | 否 | 纬度 | ||||
| lng | number | 否 | 经度 | ||||
| ad_info | object | 否 | 行政区划信息 | ||||
| adcode | number | 是 | 行政区划代码 | ||||
| province | string | 否 | 省 如果当前城市为直辖市，如果policy=1/2/3，则返回空 如果policy=4/5，则返回直辖市 |
||||
| city | string | 否 | 市，如果当前城市为省直辖县级区划，city与district字段均会返回此城市 注：省直辖县级区划adcode第3和第4位分别为9、0，如济源市adcode为419001 |
||||
| district | string | 否 | 区 | ||||
| _distance | number | 否 | 该POI/AOI到逆地址解析传入的坐标的直线距离 | ||||
| _dir_desc | string | 否 | 该POI/AOI在逆地址解析传入的坐标的相对方位描述，包括：东、东南、南、西南、西、西北、北、东北、内（输入经纬度在AOI范围内） | ||||
调用示例
//GET请求示例，注意参数值要进行URL编码
https://apis.map.qq.com/ws/geocoder/v1/?location=39.984154,116.307490&key=[你的key]&get_poi=1
在线测试
这篇文章对您解决问题是否有帮助？
已解决
未解决