逆地理编码

接口说明

经纬度 → 地址，支持全国坐标反查

输入示例：经纬度：116.480881,39.989410；半径：1000 米

返回示例：返回北京市 · 北京市 · 朝阳区 · 阜通东大街附近的地址、街道、门牌和周边信息。

请求地址

GEThttps://cloud.dtbgis.com/api/v1/regeocode

鉴权方式

在 HTTP Header 中携带你的 API Key：

X-API-Key: 你的API-Key

每个 API Key 绑定已购接口与流量豆，调用成功扣减对应流量豆；调用失败（参数错误等）不扣流量豆。未开通该接口返回 403，流量豆不足返回 429。

请求参数

参数	必填	说明	示例 / 默认值
`location`	必填	经纬度，格式 116.480881,39.989410	`116.480881,39.989410`
`radius`	可选	搜索半径（米）	`1000`
`extensions`	可选	base 或 all 可选值：默认、`base` base、`all` all	`base`

请求示例

curl -H "X-API-Key: 你的API-Key" \
  "https://cloud.dtbgis.com/api/v1/regeocode?location=116.480881%2C39.989410&radius=1000&extensions=base"

import requests

resp = requests.get(
    "https://cloud.dtbgis.com/api/v1/regeocode?location=116.480881%2C39.989410&radius=1000&extensions=base",
    headers={"X-API-Key": "你的API-Key"},
)
print(resp.status_code, resp.json())

fetch("https://cloud.dtbgis.com/api/v1/regeocode?location=116.480881%2C39.989410&radius=1000&extensions=base", {
  headers: { "X-API-Key": "你的API-Key" }
})
  .then(r => r.json())
  .then(console.log);

返回结果说明

本接口返回统一 JSON 信封结构：

{
  "code": 200,
  "msg": "success",
  "data": { ... },
  "quota_remaining": 9999
}

字段	说明
`code`	业务状态码，`200` 表示成功
`msg`	状态描述，成功为 `success`
`data`	查询结果对象，字段见下方「`data` 字段说明」
`quota_remaining`	本次调用后剩余可用流量豆数量

本接口 data 为高德原始 JSON 透传，坐标系 GCJ-02；extensions=all 时另含 pois（周边 POI）、roads（道路）、roadinters（交叉口）。如需与厂商解耦的统一格式，请使用「逆地理编码 v2」（/api/v2/regeocode）。

响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "status": "1",
    "info": "OK",
    "infocode": "10000",
    "regeocode": {
      "formatted_address": "北京市朝阳区阜通东大街6号院",
      "addressComponent": {
        "country": "中国",
        "province": "北京市",
        "city": [],
        "citycode": "010",
        "district": "朝阳区",
        "adcode": "110105",
        "township": "望京街道",
        "towncode": "110105024000",
        "neighborhood": {
          "name": "方恒国际中心",
          "type": "商务住宅;楼宇;商务写字楼"
        },
        "streetNumber": {
          "street": "阜通东大街",
          "number": "6号院",
          "location": "116.480881,39.989311",
          "direction": "北",
          "distance": "11.0107"
        }
      }
    }
  },
  "quota_remaining": 9998
}

`data` 字段说明

字段	类型	说明	示例
`status`	string	上游状态码，"1" 表示成功	`1`
`info`	string	上游状态说明	`OK`
`infocode`	string	上游状态码明细	`10000`
`regeocode`	object	逆地理编码结果对象	—
`formatted_address`	string	结构化地址全称	`北京市朝阳区阜通东大街6号院`
`addressComponent`	object	地址组成要素	—
`country`	string	国家	`中国`
`province`	string	省 / 直辖市	`北京市`
`city`	string\|array	城市名称；直辖市为空数组	`[]`
`citycode`	string	城市电话区号	`010`
`district`	string	区 / 县	`朝阳区`
`adcode`	string	行政区划编码	`110105`
`township`	string	乡镇 / 街道名称	`望京街道`
`towncode`	string	乡镇 / 街道编码（12 位）	`110105024000`
`neighborhood`	object	社区 / 地标（name 名称、type 类型）	`{name: 方恒国际中心, type: 商务住宅;楼宇}`
`streetNumber`	object	门牌信息（street 街道 / number 门牌号 / location 门址坐标 / direction 方位 / distance 距离米）	`{street: 阜通东大街, number: 6号院, ...}`

错误码

错误以统一结构返回：{"detail": {"code": 429, "msg": "..."}}

HTTP	含义	常见原因 / 处理
`400`	参数错误	缺少必填参数或格式不合法
`401`	鉴权失败	API Key 缺失、不存在、已停用或已过期
`403`	权限不足	该 API Key 未开通此接口，请购买流量豆
`429`	流量豆不足 / 限流	流量豆用完需续费；或超过速率（60 秒 200 次）
`404`	资源不存在	路径错误，或查询对象无数据
`503`	服务暂时不可用	服务暂时异常，请稍后重试

完整错误码见文档首页 · 错误码总览。