接口说明
距离计算接口支持计算多个坐标点对之间的直线距离，输入为二维数组形式，其中每个子数组包含起点和终点两个坐标。
请求方式POST
支持地区中国大陆
坐标系GCJ02（火星坐标系）
认证方式
所有 API 请求均需通过 HTTP Authorization 请求头携带 Bearer Token 进行身份验证。 Token 可在控制台的「团队设置 → API 密钥」中创建和管理。
// 请求头示例
Authorization: Bearer <YOUR_API_KEY>
Token 属于密钥凭证，请勿提交到代码仓库或公开渠道。建议通过服务端代理调用 API，避免在前端直接暴露 Token。
请求参数
POST
/api/service/distance| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| points | array | 必填 | 坐标点对数组，每项为二维数组 [[from_lat, from_lng], [to_lat, to_lng]] 格式 |
返回字段
成功响应
result: 1HTTP 200| 字段名 | 类型 | 说明 |
|---|---|---|
| result | integer | 成功标识，1 为成功 |
| list | array | 各点对的直线距离结果列表，单位为米 |
代码示例
请求示例
JavaScript
fetch('https://lts.maiyun.net/api/service/distance', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
points: [
[{ lat: 39.915, lng: 116.404 }, { lat: 39.925, lng: 116.414 }],
[{ lat: 30.623, lng: 104.079 }, { lat: 30.633, lng: 104.089 }],
],
}),
})
.then(r => r.json())
.then(data => {
console.log(data.list);
});返回示例（成功）
JSON
{
"result": 1,
"list": [12839.3, 151.01, 463450.4]
}错误码
| 错误码 | 描述 |
|---|---|
| -1 | 参数错误：points 字段缺失或格式不正确 |
| -400 | 未提供授权信息，请检查 Authorization 请求头 |
| -401 | Token 不存在或已过期，请重新获取 |
| -402 | 关联的团队账号不存在 |
| -429 | 超出 QPS 限制，请适当降低请求频率后重试 |
当请求失败时，接口将返回对应的 result 值（≤ 0）及错误描述字符串。 其中 -400 及以下为通用鉴权错误，其余为当前接口特有错误。