经纬度转地址接口_免费地理编码API_高精度逆地理解析服务

GET

接口地址：

https://v2.xxapi.cn/api/geoToAddress

请求示例：

https://v2.xxapi.cn/api/geoToAddress?lat=39.984154&lng=116.30749&poi=1

服务指标

QPS 上限

50次/秒

平均响应时间

14.14ms

接口描述

经纬度转地址接口提供专业的逆地理编码解析能力，可将GPS经纬度快速转换为详细地址信息（省市区/街道/POI），支持批量查询与高并发调用，返回结果精准稳定，适用于定位上报、地图展示、外卖配送、出行轨迹与业务风控等场景。

请求参数

怎么传递这个 Key？

推荐

方法 1：Bearer Token (Header)

标准规范，兼容性最好，最安全

Authorization:Bearer Key

方法 2：放在请求头 (Header)

直接使用 Authorization，无需前缀

Authorization:Key

方法 3：放在请求头 (Header)

自定义 Header key 字段

key:Key

不推荐

方法 4：放在网址后面 (Query)

不安全，可能泄露 Key，即将弃用

网址?key=Key

相关套餐

请求示例

Shell

JavaScript

Python

PHP

Java

Go

C#

Ruby

curl -X GET 'https://v2.xxapi.cn/api/geoToAddress?lat=${纬度}&lng=${经度}&poi=${0或1}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

返回示例

{
  "code": 200, // 状态码，200表示请求成功
  "msg": "数据请求成功",
  "data": {
    "ad_info": { // 行政区划信息
      "adcode": "110108", // 行政区划代码
      "city": "北京市", // 市
      "city_code": "156110000", // 城市代码（国家码+行政区划代码，共9位）
      "district": "海淀区", // 区
      "location": { // 行政区划中心点坐标
        "lat": 39.959893, // 纬度
        "lng": 116.2977 // 经度
      },
      "name": "中国,北京市,北京市,海淀区", // 行政区划完整名称
      "nation": "中国", // 国家
      "nation_code": "156", // 国家代码（ISO3166三位数字码）
      "province": "北京市" // 省
    },
    "address": "北京市海淀区彩和坊路", // 标准格式化地址
    "address_component": { // 结构化地址部件
      "city": "北京市", // 市
      "district": "海淀区", // 区
      "nation": "中国", // 国家
      "province": "北京市", // 省
      "street": "彩和坊路", // 街道
      "street_number": "" // 门牌号
    },
    "address_reference": { // 坐标相对位置参考信息
      "business_area": { // 商圈
        "_dir_desc": "内", // 方位关系
        "_distance": 0, // 到输入坐标的直线距离（米）
        "id": "14178584199053362783", // 地点唯一标识
        "location": {
          "lat": 39.9806,
          "lng": 116.311
        },
        "title": "中关村" // 名称
      },
      "crossroad": { // 交叉路口
        "_dir_desc": "西北",
        "_distance": 62.6,
        "id": "529961",
        "location": {
          "lat": 39.98395,
          "lng": 116.30823
        },
        "title": "彩和坊路/海淀北一街(路口)"
      },
      "famous_area": { // 知名区域
        "_dir_desc": "内",
        "_distance": 0,
        "id": "14178584199053362783",
        "location": {
          "lat": 39.9806,
          "lng": 116.311
        },
        "title": "中关村"
      },
      "landmark_l2": { // 二级地标
        "_dir_desc": "内",
        "_distance": 0,
        "id": "3629720141162880123",
        "location": {
          "lat": 39.984105,
          "lng": 116.307499
        },
        "title": "中国技术交易大厦"
      },
      "street": { // 附近街道参考点
        "_dir_desc": "西",
        "_distance": 43.7,
        "id": "1117461972434842147",
        "location": {
          "lat": 39.980318,
          "lng": 116.308315
        },
        "title": "彩和坊路"
      },
      "street_number": { // 门牌参考点
        "_dir_desc": "西",
        "_distance": 43.7,
        "id": "",
        "location": {
          "lat": 39.980318,
          "lng": 116.308315
        },
        "title": ""
      },
      "town": { // 乡镇/街道
        "_dir_desc": "内",
        "_distance": 0,
        "id": "110108012",
        "location": {
          "lat": 39.975116,
          "lng": 116.313581
        },
        "title": "海淀街道"
      }
    },
    "formatted_addresses": { // 描述性地址
      "recommend": "海淀区中关村中国技术交易大厦(海淀桥东南200米)", // 推荐精确地址
      "rough": "海淀区中关村中国技术交易大厦(海淀桥东南200米)" // 粗略地址
    },
    "location": { // 解析后的坐标
      "lat": 39.9842,
      "lng": 116.3075
    },
    "poi_count": 10, // 周边POI数量（需传poi=1）
    "pois": [ // 周边兴趣点数组
      {
        "_distance": 0, // 到输入坐标的直线距离
        "ad_info": {
          "adcode": "110108", // 行政区划代码
          "city": "北京市",
          "district": "海淀区",
          "province": "北京市"
        },
        "address": "北京市海淀区北四环西路66号", // POI地址
        "category": "房产小区:商务楼宇", // 分类信息
        "id": "3629720141162880123", // POI唯一ID
        "location": {
          "lat": 39.984105,
          "lng": 116.307499
        },
        "title": "中国技术交易大厦" // 名称
      }
    ]
  },
  "request_id": "298317e39f72ac27fcafc34d"
}