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

GET

接口地址：

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

请求示例：

https://v2.xxapi.cn/api/addressToGeo?address=深圳市南山区高新区腾讯大厦35层

服务指标

QPS 上限

50次/秒

平均响应时间

44ms

接口描述

地址转经纬度接口提供专业的地理编码解析能力，可将详细地址（省市区/街道/门牌号/企业名称）精准转换为GPS经纬度坐标，支持批量查询与高并发调用，解析速度快、数据精准稳定，适用于地图定位展示、物流轨迹规划、用户地址校验、电商订单系统、外卖配送系统、LBS应用及企业级数据分析等场景。

请求参数

怎么传递这个 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/addressToGeo?address=${中国大陆地址}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

返回示例

{
  "code": 200, // 状态码，200 表示请求成功
  "msg": "数据请求成功",
  "data": {
    "ad_info": {
      "adcode": "440305" // 行政区划代码（对应南山区）
    },
    "address_components": {
      "city": "深圳市", // 市（如为省直辖县级区划，city 与 district 相同）
      "district": "南山区", // 区，可能为空字符串
      "province": "广东省", // 省
      "street": "", // 街道/道路，可能为空字符串
      "street_number": "" // 门牌号，可能为空字符串
    },
    "deviation": 1000, // （即将下线）偏差值，建议使用 level 替代
    "level": 10, // 解析精度级别（1-11），>=9 通常可直接采用；10 表示小区/大厦级别
    "location": {
      "lat": 22.540366, // 纬度（GCJ-02 坐标系）
      "lng": 113.934559 // 经度（GCJ-02 坐标系）
    },
    "reliability": 7, // 可信度（1-10），>=7 表示结果较为准确
    "similarity": 0.99, // （即将下线）相似度，建议使用 reliability 替代
    "title": "腾讯大厦" // 标准格式化地址名称（通常为行政区划+道路+门牌号或POI名称）
  },
  "request_id": "52050bb2bd9e8e10a5da86c8"
}