行政区划查询

根据经纬度查询中国大陆的省、市和区县三级行政区划。

使用须知

• 本 API 仅支持中国大陆区域的近似搜索，存在一定误差，适用于一般 C 端使用场景。
• 每次调用消耗接口调用额度一次。

请求

GET https://singer.caiyunhub.com/v3/cartography/reverse_admins

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权
longitude	是	—	—	目标地点经度
latitude	是	—	—	目标地点纬度
lang	否	Accept-Language，其次 zh-CN	BCP 47 语言标签	行政区划名称语言，查询参数优先于请求头

如果目标语言的名称不可用，将返回数据中可用的名称。

请求示例

curl "https://singer.caiyunhub.com/v3/cartography/reverse_admins?longitude=116.36585&latitude=39.9126&lang=zh-CN&token={token}"

{
  "admins": [
    {
      "name": "北京市",
      "code": "110000",
      "level": 2
    },
    {
      "name": "北京市",
      "code": "110100",
      "level": 3
    },
    {
      "name": "西城区",
      "code": "110102",
      "level": 4
    }
  ],
  "region_code": "CN"
}

响应字段

JSONPath	类型	说明
$.admins	array<object>	行政区划列表，仅包含省、市和区县三级
$.admins[].name	string	行政区划名称
$.admins[].code	string	行政区划 adcode
$.admins[].level	number	行政区划级别：省为 2，市为 3，区县为 4
$.region_code	string	ISO 3166-1 Alpha-2 地区编码；中国大陆返回 CN

错误

详见 错误信息。