坐标转换 - 迈云位置服务 API 文档

接口说明

坐标转换（Geoconv）接口支持 WGS84（GPS 原始坐标）、BD09（BD09LL 百度坐标系）、BD09MC（百度墨卡托坐标系）到 GCJ02（国测局火星坐标系）的转换。适用于多数据源坐标统一、地图展示纠偏等场景。

请求方式POST

支持地区中国大陆

坐标系GCJ02（火星坐标系）

认证方式

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

// 请求头示例

Authorization: Bearer <YOUR_API_KEY>

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

请求参数

POST/api/service/geoconv

参数名	类型	必填	说明
from	integer	必填	源坐标系：0=WGS84（GPS），1=BD09（BD09LL 百度经纬度），2=BD09MC（百度墨卡托）
points	array	必填	待转换的坐标点列表，每个点为 { lat: number, lng: number } 格式

返回字段

成功响应result: 1HTTP 200

字段名	类型	说明
result	integer	成功标识，1 为成功
list	array	转换后的坐标列表，与请求 points 顺序对应
└lng	number	转换后的 GCJ02 经度，精确到小数点后 6 位
└lat	number	转换后的 GCJ02 纬度，精确到小数点后 6 位

代码示例

请求示例

JavaScript

fetch('https://lts.maiyun.net/api/service/geoconv', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({
        from: 0,
        points: [
            { lat: 39.961317, lng: 116.336145 },
        ],
    }),
})
    .then(r => r.json())
    .then(data => {
        const { list } = data;
        console.log(list[0].lat, list[0].lng);
        // => 39.962646, 116.342304
    });

返回示例（成功）

JSON

{
    "result": 1,
    "list": [
        {
            "lng": 116.342304,
            "lat": 39.962646
        }
    ]
}

错误码

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

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