物流路网计算

所有文档

服务概览

快速开始

使用准备

接口文档

服务功能

物流路网创建物流路网查询

相关资料

更新日志常见问题资源下载使用指南

物流路⽹创建

下载开发文档

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(货车，车辆长宽高6m2m3m)、NORMAL(小客车)。仅支持选择一个类型
qps			Integer	否	并发数量，默认1；用户可按自己账户可用并发数进行设置，单次请求最大并发不能大于100；

返回参数

字段名称	字段类型	备注
id	String	路网ID
commitId	String	路网版本（增加网点删除网点更新网点，路网版本会变化，路网ID不变）
status	String	RUNNING, FINISHED, ERROR 计算状态
errorCode	String	错误码
errorMessage	String	错误信息

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

code	message	httpStatus	说明
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	内部服务错误	服务异常，请前往反馈工单联系我们。

接⼝常⻅异常

分类	code	message	httpStatus	说明
策略校验	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查看

请联系商务协调⽀持。

使用准备

物流路网查询

本篇文章对您是否有帮助？