行政区列表 - 迈云位置服务 API 文档

接口说明

行政区列表接口返回全国所有省、市、区县、乡镇四级行政区划数据，包含行政区编码、名称、层级和中心坐标，适用于区域筛选控件、下拉选择器等场景。

请求方式GET

支持地区中国大陆

坐标系GCJ02（火星坐标系）

认证方式

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

// 请求头示例

Authorization: Bearer <YOUR_API_KEY>

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

请求参数

GET/api/service/scenario/list

该接口无请求参数

返回字段

成功响应result: 1HTTP 200

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

代码示例

请求示例

JavaScript

fetch('https://lts.maiyun.net/api/service/scenario/list', {
    method: 'GET',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
    },
})
    .then(r => r.json())
    .then(data => {
        console.log(data.result);
    });

返回示例（成功）

JSON

{
    "status": 0,
    "message": "success",
    "data_version": "20250721",
    "result": [
        {
            "adcode": "110000",
            "province": "北京市",
            "level": 1,
            "location": { "lat": 39.911, "lng": 116.405 }
        },
        {
            "adcode": "110100",
            "province": "北京市",
            "city": "北京市",
            "level": 2,
            "location": { "lat": 39.911, "lng": 116.405 }
        },
        {
            "adcode": "110101",
            "province": "北京市",
            "city": "北京市",
            "district": "东城区",
            "level": 3,
            "location": { "lat": 39.917, "lng": 116.418 }
        }
    ]
}

错误码

错误码	描述
-400	未提供授权信息，请检查 Authorization 请求头
-401	Token 不存在或已过期，请重新获取
-402	关联的团队账号不存在

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