历史地址标准化 - 迈云位置服务 API 文档

接口说明

历史地址标准化接口将中国大陆完整地址开头的旧行政区划名称转换为当前名称，适用于清洗历史订单、客户资料和地址库。支持省地县、省县、地县及直辖市区县等常见层级组合；详细地址不会被替换，拆分归属无法确定时保留原地址。数据覆盖 2005 年以来可明确识别的行政区划变更。

请求方式POST

支持地区中国大陆

数据范围2005 年以来

认证方式

此接口支持游客调用，无需携带 API Key；游客请求受 IP 频率限制。携带有效 API Key 调用时，按所在团队的 QPS 与通用额度执行。

请求参数

POST/api/service/division

参数名	类型	必填	说明
address	string	必填	待标准化的完整地址，支持省地县、省县、地县等层级组合，如：山东省临沂市苍山县卞庄街道文峰路

返回字段

成功响应result: 1HTTP 200

字段名	类型	说明
result	integer	成功标识，1 为成功
address	string	标准化后的地址；没有可明确转换的区划或归属无法判断时，返回原地址

代码示例

请求示例

JavaScript

fetch('https://lts.maiyun.net/api/service/division', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({
        address: '山东省临沂市苍山县卞庄街道文峰路',
    }),
})
    .then(r => r.json())
    .then(data => {
        console.log(data.address);
        // => 山东省临沂市兰陵县卞庄街道文峰路
    });

返回示例（成功）

JSON

{
    "result": 1,
    "address": "山东省临沂市兰陵县卞庄街道文峰路"
}

错误码

错误码	描述
-1	参数错误：address 字段缺失或不为字符串类型
-10	携带 API Key 调用时额度不足，请充值后重试
-429	请求频率超限，请稍后重试
-21 ~ -24	服务内部错误，请稍后重试

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