排单排线计算
POST
/ros/v1/scheduler/problem
请求参数
参数名称 | 参数类型 | 是否必须 | 参数说明 | |
---|---|---|---|---|
scenesType | String | 必须 | 算法需要使用的场景类型,场景维度包含网点规模及排单结果路线交叉程度。枚举:LARGE_SCALE_CLUSTER:大规模聚集性场景,SMALL_SCALE_CLUSTER:小规模聚集性场景,LARGE_SCALE_GENERAL:大规模通用场景,SMALL_SCALE_GENERAL:小规模通用场景。大规模场景要求网点数在600点以上,小规模场景网点数600点以下。聚集性为路线不交叉,但是成本不一定最低,通用性为路线可能交叉,但是成本最低 | |
matrixId | String | 必须 | 路网矩阵ID,路网矩阵唯一标识码 | |
lbsType | String | 必须 | 路网矩阵类型,枚举。LEAST_TIME:时间优先,LEAST_DISTANCE:距离最短,NO_HIGHWAY:不走高速。 用户可以根据自己场景填写 | |
commitId | String | 非必须 | 路网矩阵版本ID | |
distanceType | String | 必须 | 距离计算方式,枚举。STRAIGHT:直线距离, TRAVEL:导航距离。直线距离计算场景必须设置车辆的平均行驶速度 | |
depots | List | 必须 | 仓库信息列表,一期支持单仓 | |
depotId | String | 必须 | 仓库ID,用户仓库自定义参数 | |
depotTimeWindow | TimeWindow | 非必须 | 时间窗信息,时间约束条件,车辆最早出仓时间和最晚回仓时间 | |
startTime | int | 非必须 | 起始时间,单位:分钟,取值范围大于0。例如,上午10点30分的取值为630 | |
endTime | int | 非必须 | 结束时间,单位:分钟,取值范围大于1 | |
vehicleGroups | List | 必须 | 该仓库的车辆组信息 | |
vehicleTypeId | String | 必须 | 车辆类型ID,枚举,目前支持GB01(默认车辆长6000mm,宽2100mm,高3000mm)以及SMALL(小轿车,车辆长4000mm,宽2000mm,高2000mm),两种车辆类型的轴重轴数均为2。该信息用于道路货车限行规避,一个车辆类型会对应一个或多个型号的货车,由用户自行决定车辆型号与车辆类型的映射关系 | |
vehicleModelId | String | 必须 | 车辆型号ID,用户自定义参数 | |
vehicleCount | int | 必须 | 该型号车数量,不小于0,0代表没有限制 | |
minVisited | int | 非必须 | 车辆允许运送的最小订单数量,不小于0,0代表没有限制 | |
maxVisited | int | 非必须 | 车辆允许运送的最大订单数量,不小于0,0代表没有限制 | |
maxRunDistance | int | 非必须 | 车辆最大行驶距离,单位:米,不小于0,0代表没有限制 | |
maxRunTime | int | 非必须 | 车辆最大行驶时间,单位:分钟,不小于0,0代表没有限制 | |
vehicleSkills | List | 非必须 | 车辆可运输的货物类型列表(车辆具备某种运输能力,如冷冻功能、运输危化品能力等) | |
returnToDepot | boolean | 非必须 | 是否回仓,默认回仓 | |
vehicleModels | List | 必须 | 车辆型号信息 | |
vehicleModelId | String | 必须 | 车辆型号ID,用户自定义 | |
capacity | Capacity | 必须 | 车辆额定承载 | |
weight | double | 非必须 | 装载重量,单位:千克。精度:保留小数点后四位 | |
volume | double | 非必须 | 装载体积,单位:立方米。精度:保留小数点后四位 | |
count | double | 非必须 | 装载数量,精度:保留小数点后四位。重量、体积、数量三个维度至少填写一个,车和货的维度保持一致 | |
perDistanceUnitPrice | double | 必须 | 车辆每公里行驶成本,取值必须大于0,单位:元/公里 | |
perTimeUnitPrice | double | 非必须 | 车辆每单位时间行驶成本,取值必须大于0,单位:元/分钟 | |
fixedCost | double | 非必须 | 车辆固定损耗成本,单位:元/天,默认值为0 | |
waitingCost | double | 非必须 | 车辆等待成本,单位:元/分钟,默认值为0 | |
averageVelocity | double | 非必须 | 平均车速,取值必须在0到120之间,单位:千米/小时,distanceType为STRAIGHT时,该参数必填 | |
maxVelocity | double | 非必须 | 最大行驶速度,取值必须在0到120之间,且必须大于平均车速,单位:千米/小时 | |
serviceJobs | List | 必须 | 网点信息列表 | |
serviceJobId | String | 必须 | 网点ID,用户自定义参数 | |
serviceStayDuration | double | 非必须 | 网点停留时间,取值必须大于0,单位:分钟,默认值为0 | |
demand | Capacity | 必须 | 网点待配送货物的量 | |
weight | double | 非必须 | 装载重量,单位:千克。精度:保留小数点后四位 | |
volume | double | 非必须 | 装载体积,单位:立方米。精度:保留小数点后四位 | |
count | double | 非必须 | 装载数量,精度:保留小数点后四位。重量、体积、数量三个维度至少填写一个,车和货的维度保持一致 | |
serviceTimeWindows | List | 非必须 | 网点可配送的时间段列表 | |
startTime | int | 非必须 | 起始时间,单位:分钟,取值范围大于0 。例如,上午10点30分的取值为630 | |
endTime | int | 非必须 | 结束时间,单位:分钟,取值范围大于1 | |
skills | List | 非必须 | 需要运输的货物类型列表(车辆需要具备某种运输能力,如冷冻功能、运输危化品能力等) | |
priority | int | 非必须 | 订单优先级,取值范围必须为不小于1,不大于10,数字越大代表优先级越高 |
status服务状态码
返回码 | 定义 | 常见原因 |
---|---|---|
200 | 返回成功 | 服务请求正常召回 |
400 | 请求失败 | 请求参数不合法,请按照返回提示修改参数 |
401 | 未鉴权 | ak不合法或者账号未开通相应权限 |
403 | 禁止 | 未开通白名单,请前往反馈工单联系我们 |
503 | 服务不可用 | 服务异常,请前往反馈工单联系我们 |
500 | 内部服务错误 | 服务异常,请前往反馈工单联系我们 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.map.baidu.com/ros/v1/scheduler/problem?scenesType&matrixId&lbsType&distanceType&depots&vehicleModels&serviceJobs&ak='
响应示例响应示例
{
"id": "8b664a457cdd42ec871e8344368c5d79",
"status": "RUNNING",
"errorCode": "",
"errorMessage": ""
}
请求参数
Query 参数
scenesType
string
必需
matrixId
string
必需
lbsType
string
必需
commitId
string
路网矩阵版本ID
distanceType
string
必需
depots
string
必需
vehicleModels
string
车辆型号信息
serviceJobs
string
网点信息列表
ak
string
必需
默认值:
{{ak}}
Body 参数application/x-www-form-urlencoded
object {0}
返回响应
修改于 2022-08-22 02:10:40