逆地址解析 - 迈云位置服务 API 文档

接口说明

逆地址解析（Reverse Geocoding）接口能够根据经纬度坐标，返回该位置对应的详细地址字符串、行政区划信息。支持多种坐标系输入，统一输出 GCJ02 坐标。

请求方式POST

支持地区中国大陆

坐标系GCJ02（火星坐标系）

认证方式

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

// 请求头示例

Authorization: Bearer <YOUR_API_KEY>

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

请求参数

POST/api/service/geocode

参数名	类型	必填	说明
from	integer	必填	输入坐标系：0=WGS84，1=BD09（BD09LL），2=BD09MC，3=GCJ02
point	object	必填	查询点坐标，格式 { lat: number, lng: number }

返回字段

成功响应result: 1HTTP 200

字段名	类型	说明
result	integer	成功标识，1 为成功
name	string	经过格式化处理后的完整地址字符串
point	object	标准化后的 GCJ02 坐标
└lng	number	经度
└lat	number	纬度
address	object	结构化地址信息
└name	string	经过格式化处理后的完整地址字符串
└context	object	行政区划上下文
└country	object	国家，格式 { name, code }
└province	object	省份，格式 { name, code }
└city	object	城市，格式 { name, code }
└district	object	区县，格式 { name, code }
└township	object	街道/乡镇，格式 { name, code }

代码示例

请求示例

JavaScript

fetch('https://lts.maiyun.net/api/service/geocode', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({
        from: 0,
        point: { lat: 36.066833, lng: 120.38265 },
    }),
})
    .then(r => r.json())
    .then(data => {
        console.log(data.name);
    });

返回示例（成功）

JSON

{
    "result": 1,
    "name": "市南区**定位点",
    "point": {
        "lng": 120.387783,
        "lat": 36.067109
    },
    "address": {
        "name": "山东省青岛市市南区香港中路街道徐州路新贵都",
        "context": {
            "country": {
                "name": "中国",
                "code": "CN"
            },
            "province": {
                "name": "山东省",
                "code": "370000"
            },
            "city": {
                "name": "青岛市",
                "code": "370200"
            },
            "district": {
                "name": "市南区",
                "code": "370202"
            },
            "township": {
                "name": "香港中路街道",
                "code": "370202001"
            }
        }
    }
}

错误码

错误码	描述
-1	参数错误：from、point 字段缺失或类型不正确
-3	坐标超出支持范围（仅支持中国大陆地区）
-400	未提供授权信息，请检查 Authorization 请求头
-401	Token 不存在或已过期，请重新获取
-402	关联的团队账号不存在
-429	超出 QPS 限制，请适当降低请求频率后重试

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