距离矩阵 APIDistance Matrix

多起点多终点批量测距

距离测算接口路径 /v3/distance默认 QPS 10已售 864 个次数包数据更新：实时

接口介绍

一次请求计算多个起点到多个终点之间的直线或驾车距离与耗时，单次最多 100 × 100 个点对，适用于分单派单、网点匹配、运费估算、就近调度等需要批量测距的业务。

适用场景

同城配送智能分单、就近派单
客户到最近网点 / 门店匹配
按距离阶梯计算运费
车队就近调度

请求参数

参数	类型	必填	说明
`origins`	string	是	起点坐标，多个以 \| 分隔，最多 100 个
`destination`	string	是	终点坐标，多个以 \| 分隔，最多 100 个
`type`	int	否	0 直线距离、1 驾车距离（默认）、3 步行距离
`key`	string	是	接口密钥（AppKey），在控制台申请
`output`	string	否	返回格式，json（默认）或 xml
`sig`	string	否	数字签名，开启签名校验后必填

请求示例

GET https://api.dkkj66.top/v3/distance?key=您的AppKey&origins=...

支持 GET / POST，需使用 HTTPS；返回默认 JSON，可用 output=xml 切换。签名校验与 IP 白名单在控制台开启，见开发文档 · 鉴权。

返回示例

{
  "status": "1",
  "results": [
    {"origin_id": "1", "dest_id": "1", "distance": "3260", "duration": "612"},
    {"origin_id": "1", "dest_id": "2", "distance": "7810", "duration": "1204"}
  ]
}

错误码

错误码	说明	处理建议
`10000`	请求成功	-
`10001`	key 不正确或过期	检查控制台密钥状态
`10003`	访问已超出日访问量	购买次数包或次日再试
`10004`	单位时间内访问过于频繁	降低并发，或升级套餐提升 QPS
`10005`	IP 白名单出错	在控制台配置服务器 IP
`20000`	请求参数非法	按文档检查参数名与取值
`20001`	缺少必填参数	补齐参数后重试
`20003`	请求协议非法	请使用 HTTPS
`30001`	引擎返回数据异常	稍后重试，持续出现请提交工单