WebService API
    开发指南
示例中心
  • 更新日志
    • 常见问题
    WebService API
    开发指南
    海外服务
    逆地址解析（坐标位置描述）

    概述

    本接口提供由经纬度到文字地址及相关位置信息的转换能力，广泛应用于物流、出行、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
    added_fields 否 控制额外返回字段，取值：
    time_zone，时区信息    		 added_fields=time_zone
    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 是 国家代码
    time_zone object 否 时区信息，设置added_fields=time_zone时返回
    name string 是 IANA 时区名，如：Asia/Shanghai
    utc_offset string 是 当前 UTC 偏移（含夏令时），格式：+HH:MM / -HH:MM

    调用示例

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