行政区域查询 API

行政区域查询API提供了通过关键词获取行政区划信息的能力。

区域搜索 API

接口描述

通过关键词，获取其所在的行政区域信息。

请求方式

URL	请求方式
https://lbs.xiaojukeji.com/api/v2/district	POST、GET

请求

查询参数（GET）

参数名	必选	类型	描述	示例值
key	是	string	鉴权用的 API Key	YOUR_API_KEY
keyword	是	string	关键词，支持行政区名称、adcode	北京市
subdistrict	否	integer	下级行政区级数，0-不返回下级，1-返回下一级	0
extensions	否	string	扩展信息，all/base	base

请求体参数（POST）

• keyword: string，关键词，支持行政区名称、adcode
• subdistrict: integer，下级行政区级数，0-不返回下级，1-返回下一级
• extensions: string，扩展信息，all/base

请求示例

GET

curl -X GET "https://lbs.xiaojukeji.com/api/v2/district?key=YOUR_API_KEY&keyword=北京市"

POST

curl -X POST "https://lbs.xiaojukeji.com/api/v2/district?key=YOUR_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
  "keyword": "北京市",
  "subdistrict": 0,
  "extensions": "base"
}'

响应

成功响应为 DistrictRPCResponse 模型的JSON格式。

响应示例

{
  "status": 10000,
  "msg": "success",
  "trace_id": "0ac5186e67e50a9c190b048d5ef3dab0",
  "results": {
    "districts": [
      {
        "adcode": "110000",
        "name": "北京市",
        "level": "province",
        "center": {"lat": 39.9042, "lng": 116.4074},
        "districts": []
      }
    ]
  }
}