AI
产品服务
解决方案
文档与支持
定价

所有文档

物流路网计算

更新时间: 2026/03/24 10:24
物流路⽹创建
下载开发文档
API服务地址

https://api.map.baidu.com/ros/v2/matrix/fast?ak=您的AK
// POST请求

请求参数
参数名称字段类型是否必填参数说明

name

String

路网矩阵名称

locationType

String

默认值:bd09ll。gcj02:国测局加密坐标;bd09ll:百度经纬度坐标;bd09mc:百度墨卡托坐标

locations

List<Location>

网点信息列表; 如果填写该参数,则输出n(网点数)*n(网点数)的路网结果,且网点对信息列表参数不可填; 如果不填写该参数,则网点对信息列表参数必填。

latitude

Double

坐标的纬度

longitude

Double

坐标的经度

key

String

客户网点的唯一key,长度最大32,路网中不允许出现key相同的情况

name

String

网点名称

locationPairs

Object

网点对信息列表; 如果填写该参数,则输出m(起点网点数)*n(终点网点数)的路网结果,且网点信息列表参数不可填; 如果不填写该参数,则网点信息列表参数必填。

startLocations

List<Location>

起点网点信息列表

latitude

Double

坐标的纬度

longitude

Double

坐标的经度

key

String

客户网点的唯一key,排单排线需要用到,长度最大32,路网中不允许出现key相同的情况

name

String

网点名称

endLocations

List<Location>

终点网点信息列表

latitude

Double

坐标的纬度

longitude

Double

坐标的经度

key

String

客户网点的唯一key,排单排线需要用到,长度最大32,路网中不允许出现key相同的情况

name

String

网点名称

lbsType

List<String>

LEAST_TIME:时间优先,NO_HIGHWAY:不走高速;仅支持选择一个类型

vehicleType

List<String>

车辆类型,枚举,目前支持GB01(货车,车辆长宽高6m*2m*3m)、NORMAL(小客车)。仅支持选择一个类型

qps

Integer

并发数量,默认1;用户可按自己账户可用并发数进行设置,单次请求最大并发不能大于100;

返回参数
字段名称字段类型备注

id

String

路网ID

commitId

String

路网版本(增加网点删除网点更新网点,路网版本会变化,路网ID不变)

status

String

RUNNING, FINISHED, ERROR 计算状态

errorCode

String

错误码

errorMessage

String

错误信息

以下控制服务报错需要联系商务申请权限与额度。

codemessagehttpStatus说明

Unauthorized

APP服务被禁用

401

ak没权限

Unauthorized

天配额超限,限制访问

401

ak每日配额用尽

Unauthorized

当天并发量已经超过约定并发配额,限制访问

401

ak并发超限

请求参数示例
{
"name": "fast_matrix",
"locationType": "bd09ll",
"lbsType": ["LEAST_TIME"],
"vehicleType": ["GB01"],
"locations": [
{
"key": "TEST001",
"latitude": 31.089645833179578,
"longitude": 121.42162870347656
},
{
"key": "TEST002",
"latitude": 31.286520054671293,
"longitude": 121.48459138582368
},
{
"key": "TEST003",
"latitude": 31.394079447883307,
"longitude": 121.23975327839888
}
]
}
返回参数示例
{
"id": "86caea91d2fa4770ab71942203e0efd1",
"commitId": "1de04a7334544be3a60720d05a008807",
"status": "RUNNING"
}
服务状态码
返回码定义常见原因

200

返回成功

服务请求正常召回

400

请求失败

请求参数不合法,请按照返回提示修改参数

401

未鉴权

ak不合法或者账号未开通相应权限

403

禁止

未开通白名单,请前往反馈工单联系我们。

503

服务不可用

服务异常,请前往反馈工单联系我们。

500

内部服务错误

服务异常,请前往反馈工单联系我们。

接⼝常⻅异常
分类codemessagehttpStatus说明

策略校验

InvalidRequestParam

lbsTypes can't be empty

400

策略不能为空

InvalidRequestParam

lbsType {} is not support

400

策略非法

网点校验

InvalidRequestParam

locationType can't be empty

400

坐标类型不能为空

InvalidRequestParam

locations can't be empty

400

坐标列表不能为空

MatrixPointError

网点中的信息有空值

400

网点信息必填项没有填

MatrixLocationKeyError

网点中的key最长为32

400

key校验

KeyRepeatError

key重复,请修改后重新提交

400

key重复

AvailableLocationError

网点中可用的网点必须大于1

404

网点大于1

车型校验

InvalidRequestParam

requestVehicleTypes can't be empty

400

车型不能为空

InvalidRequestParam

requestVehicle {} is not support

400

车型非法

配额校验

MatrixPointCountLimit

路网中最大网点超出限制

400

路网网点超过最大值(默认1000)

底层创建任务

ExceedUserTaskConcurrency

用户任务并行计算额度超限,暂时无法创建任务

400

并行计算额度超限(默认5)

ServerInternalError

服务器内部错误

500

底层内部问题,需要联系rd查看

请联系商务协调⽀持。

上一篇

使用准备

下一篇

物流路网查询
本篇文章对您是否有帮助?