浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

所有文档

智能调度多仓排单服务

多仓排单排线计算
下载开发文档
API服务地址

https://api.map.baidu.com/ros/v1/scheduler/multidepot?ak=您的AK
//POST请求

请求参数
参数名称参数类型必填参数说明
scenesTypeString算法需要使用的场景类型,场景维度包含网点规模及排单结果路线交叉程度。枚举:LARGE_SCALE_CLUSTER:大规模聚集性场景,SMALL_SCALE_CLUSTER:小规模聚集性场景,LARGE_SCALE_GENERAL:大规模通用场景,SMALL_SCALE_GENERAL:小规模通用场景。大规模场景要求网点数在600点以上,小规模场景网点数600点以下。聚集性为路线不交叉,但是成本不一定最低,通用性为路线可能交叉,但是成本最低
matrixIdString路网矩阵ID,路网矩阵唯一标识码
lbsTypeString路网矩阵类型,枚举,一期仅提供 LEAST_TIME:时间优先
commitIdString路网矩阵版本ID
distanceTypeString距离计算方式,枚举。STRAIGHT:直线距离 TRAVEL:导航距离
depotsList<MultiDepotExternalDepot>仓库信息列表,一期支持单仓
depotIdString仓库ID,用户仓库自定义编码
depotTimeWindowExternalTimeWindow时间窗信息,时间约束条件,车最早出仓时间和最晚回仓时间。
startTimeint起始时间,单位为分钟,取值范围大于0
endTimeint结束时间,单位为分钟,取值范围大于1
vehicleModelsList<ExternalVehicleModel> 车辆型号信息
vehicleModelIdString 车辆型号ID,用户自定义
capacityExternalCapacity车辆额定承载
weightdouble装载重量,单位:千克
volumedouble装载体积,单位:立方米
countdouble装载数量,重量、体积、数量三个维度至少填写一个,车和货的维度保持一致
serviceTimeWindowsList<ExternalTimeWindow>网点时间窗列表
startTimeint起始时间,单位为分钟,取值为[0-1439]
endTimeint结束时间,单位为分钟,取值为[1-1440]
skillsList<String>仓库可存储的货物类型列表
pricedouble价格。取值不可小于0
priorityint订单优先级,取值范围必须为不小于1,不大于10
vehicleGroupsList<MultiDepotExternalVehicleGroup>车辆信息列表
vehicleTypeIdString车辆类型ID,枚举,目前支持GB01(默认车辆长6000mm,宽2100mm,高3000mm)以及SMALL(小轿车,车辆长4000mm,宽2000mm,高2000mm),两种车辆类型的轴重轴数均为2。该信息用于道路货车限行规避,一个车辆类型会对应一个或多个型号的货车,由用户自行决定车辆型号与车辆类型的映射关系
vehicleModelIdString车辆型号ID,用户自定义参数
depotIdString车辆所属仓库ID,用户仓库自定义编码
vehicleCountint该型号车数量,不小于0,0代表没有限制
minVisitedint车辆允许运送的最小订单数量,不小于0,0代表没有限制
maxVisitedint车辆允许运送的最大订单数量,不小于0,0代表没有限制
maxRunDistanceint车辆最大行驶距离,单位:米,不小于0,0代表没有限制
maxRunTimeint车辆最大行驶时间,单位:分钟,不小于0,0代表没有限制
serviceTimeWindowExternalTimeWindow车辆可运输的时间窗
startTimeint起始时间,单位为分钟,取值范围大于0
endTimeint结束时间,单位为分钟,取值范围大于1
vehicleSkillsList<String>车辆可运输的货物类型列表
returnToDepotboolean是否回仓,默认回仓
返回参数
字段名称字段类型备注
idString排单排线计算任务ID
statusString任务执行状态:RUNNING、ERROR
errorCodeString错误码
errorMessageString错误信息
请求参数示例
POST https://api.map.baidu.com/ros/v1/scheduler/multidepot?ak={您的AK} HTTP/1.1
{
"scenesType": "SMALL_SCALE_GENERAL",
"matrixId": "550e8400e29b41d4a716446655440000",
"lbsType": "LEAST_TIME",
"commitId": "550e8400e29b41d4a716446655440000",
"distanceType": "TRAVEL",
"depots": [{
"depotId": "550e8400e29b41d4a716446655440000",
"depotTimeWindow": {
"startTime": 0,
"endTime": 1440
}
}],
"vehicleModels": [{
"vehicleModelId": "VEHICLE_MODEL_ID01",
"capacity": {
"count": 100.0
},
"perDistanceUnitPrice": 3.5,
"fixedCost": 50.0
},
{
"vehicleModelId": "VEHICLE_MODEL_ID02",
"capacity": {
"count": 200.0
},
"perDistanceUnitPrice": 5.5,
"fixedCost": 80.0
}
],
"serviceJobs": [{
"locationId": "550e8400e29b41d4a716446655440000",
"parentId": "550e8400e29b41d4a716446655440000",
"depotId": "550e8400e29b41d4a716446655440000",
"serviceStayDuration": 20.0,
"demand": {
"count": 30.0
}
},
{
"locationId": "550e8400e29b41d4a716446655440001",
"parentId": "550e8400e29b41d4a716446655440001",
"depotId": "550e8400e29b41d4a716446655440000",
"serviceStayDuration": 10.0,
"demand": {
"count": 10.0
}
},
{
"locationId": "550e8400e29b41d4a716446655440002",
"parentId": "550e8400e29b41d4a716446655440002",
"depotId": "550e8400e29b41d4a716446655440000",
"serviceStayDuration": 25.0,
"demand": {
"count": 80.0
}
}
],
"vehicleGroups": [{
"vehicleTypeId": "GB01",
"vehicleModelId": "VEHICLE_MODEL_ID01",
"depotId":"550e8400e29b41d4a716446655440000",
"vehicleCount": 0,
"serviceTimeWindow": {"startTime":0.0,"endTime":1440.0}
},
{
"vehicleTypeId": "GB01",
"vehicleModelId": "VEHICLE_MODEL_ID02",
"depotId":"550e8400e29b41d4a716446655440000",
"vehicleCount": 10,
"serviceTimeWindow": {"startTime":0.0,"endTime":1440.0}
}
],
"parameters": [
"algo.vrpObjective=minTime"
]
}
返回参数示例
{
"id" : "8b664a457cdd42ec871e8344368c5d79",
"status": "RUNNING",
"errorCode": "",
"errorMessage": ""
}
服务状态码
返回码定义常见原因
200返回成功服务请求正常召回
400请求失败请求参数不合法,请按照返回提示修改参数
401未鉴权ak不合法或者账号未开通相应权限
403禁止未开通白名单,请前往反馈工单联系我们。
503服务不可用服务异常,请前往反馈工单联系我们。
500内部服务错误服务异常,请前往反馈工单联系我们。

上一篇

使用准备

下一篇

多仓排单排线查询

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