下级行政区 - 迈云位置服务 API 文档

接口说明

下级行政区接口根据指定的上级行政区编码（adcode）返回其所有直属下级行政区数据，支持可选返回边界坐标（polygon），适用于级联选择器、地图区域绘制等场景。

请求方式POST

支持地区中国大陆

坐标系GCJ02（火星坐标系）

认证方式

所有 API 请求均需通过 HTTP Authorization 请求头携带 Bearer Token 进行身份验证。 Token 可在控制台的「团队设置 → API 密钥」中创建和管理。

// 请求头示例

Authorization: Bearer <YOUR_API_KEY>

Token 属于密钥凭证，请勿提交到代码仓库或公开渠道。建议通过服务端代理调用 API，避免在前端直接暴露 Token。

请求参数

POST/api/service/scenario/children

参数名	类型	必填	说明
parent	string	可选	上级行政区编码（adcode），不传则返回省级列表
polygon	boolean	可选	是否返回边界坐标数据，默认 false

返回字段

成功响应result: 1HTTP 200

字段名	类型	说明
status	integer	状态码，0 为成功
message	string	返回信息
data_version	string	数据版本号，格式如 20250721
result	array	下级行政区列表
└adcode	string	行政区编码
└province	string	省份名称
└city	string	城市名称
└district	string	区县名称
└level	integer	行政级别：1=省，2=市，3=区县，4=乡镇
└location	object	行政区中心坐标，GCJ02 坐标系
└lat	number	纬度
└lng	number	经度
└polygon	array	边界坐标点数组（polygon=true 时返回），每个元素为 [lng, lat] 格式的坐标点

代码示例

请求示例

JavaScript

fetch('https://lts.maiyun.net/api/service/scenario/children', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({
        parent: '110100',
        polygon: true,
    }),
})
    .then(r => r.json())
    .then(data => {
        console.log(data.result);
    });

返回示例（成功）

JSON

{
    "status": 0,
    "message": "success",
    "data_version": "20250721",
    "result": [
        {
            "adcode": "110101",
            "province": "北京市",
            "city": "北京市",
            "district": "东城区",
            "level": 3,
            "location": { "lat": 39.917, "lng": 116.418 },
            "polygon": [
                [116.3621, 39.9443],
                [116.4283, 39.9443],
                [116.4283, 39.8899],
                [116.3621, 39.8899]
            ]
        }
    ]
}

错误码

错误码	描述
-1	参数错误：parent 不是有效的 adcode 格式
-400	未提供授权信息，请检查 Authorization 请求头
-401	Token 不存在或已过期，请重新获取
-402	关联的团队账号不存在

当请求失败时，接口将返回对应的 result 值（≤ 0）及错误描述字符串。其中 -400 及以下为通用鉴权错误，其余为当前接口特有错误。