概述

本接口提供由经纬度到文字地址及相关位置信息的转换能力,广泛应用于物流、出行、O2O、社交等场景。


请求URL

    该请求为GET请求

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

请求参数

参数 必填 说明 示例
key 开发密钥(Key) key=OB4BZ-D4W3U-XXXXX
location 需要解析的经纬度(需为国外) 41.8840047,-87.630220
language 返回结果的语言:
cn [默认]中文
local 当地语言
支持的语言列表详见附录
language=en
output 返回格式:支持JSON/JSONP,默认JSON output=json
callback JSONP方式回调函数 callback=function1

:接口中文支持并不完整(部分字段可能无中文翻译),如需完整一致的体验建议使用英文参数。

响应结果

名称 类型 必有 说明
status number 状态码,0为正常
message string 状态说明
result object 逆地址解析结果
location object 坐标
lat number 纬度
lng number 经度
address string 地址
address_component object 地址部件,address不满足需求时可自行拼接
nation string 国家
ad_level_1 string 一级行政区划:一般为州(美国state)/县(日本)
ad_level_2 string 二级区划,一般为郡/县(county)
ad_level_3 string 三级区划,一般为市(city)
ad_level_4 string 四级区划,一般为区(district)
ad_level_5 string 五级区划,一般为社区
street string 街道,可能为空字串
street_number string 门牌号
ad_info object 行政区划信息
nation string 国家
nation_code string 国家代码

调用示例

//GET请求示例,注意参数值要进行URL编码
https://apis.map.qq.com/ws/geocoder/v1?location=41.8840047,-87.6302201&key=API_KEY&language=cn