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

所有文档

智能调度快速排单服务

快速排单计算
下载开发文档
API服务地址

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

请求参数
字段名称参数类型必填参数说明
orderTypeStringACCURATE_ORDER:精准排单(支持不高于200个待配送网点的排单计算,采用真实的导航距离的方式进行计算,计算结果精准,速度相对于极速排单略慢)
depotsList<FastOrderDepot>仓库信息,目前只支持单仓模式
depotIdString仓库ID,用户仓库自定义参数
locationLocationPoint仓库坐标
latitudedouble纬度
longitudedouble经度
depotTimeWindowTimeWindow时间窗信息,精准排单场景按照仓库出发时间startTime的预测路况进行排单计算,建议设置实际的出仓时间来提升预估行驶里程及时间的准确度
startTimeint起始时间,单位为分钟,取值范围大于0 。(例如:6点15分,取值为375)
endTimeint结束时间,单位为分钟,取值范围大于1
vehicleGroupsList<FastOrderVehicleGroup>该仓库的车辆组信息
vehicleTypeIdString车辆类型ID,枚举,目前支持GB01(货车,默认车辆长宽高6000mm,宽2100mm,高3000mm)、NORMAL(小客车)。该信息用于道路货车限行规避,一个车辆类型会对应一个或多个型号的货车,由用户自行决定车辆型号与车辆类型的映射关系
vehicleModelIdString车辆型号ID,用户自定义参数
vehicleCountint该型号车数量,不小于0,0代表没有限制
maxVisitedint车辆允许运送的最大订单数量,不小于0,0代表没有限制
maxRunDistanceint车辆最大行驶距离,单位:米,不小于0,0代表没有限制
maxRunTimeint车辆最大行驶时间,单位:分钟,不小于0,0代表没有限制
returnToDepotint是否回仓,1为回仓,2为不回仓(不回仓的时候,默认车辆停留在配送的最后一个点),默认回仓
departureLocationKeyString车辆起始坐标对应key
departureLocationLocationPoint车辆起始坐标,不填默认为仓库坐标
latitudedouble纬度
longitudedouble经度
startTimeint车辆起始时间,单位为分钟,取值范围大于0 。出发点为仓库时建议与出仓时间保持一致
endTimeint车辆结束时间,单位为分钟,取值范围大于1
vehicleModelsList<VehicleModel>车辆型号信息
vehicleModelIdString车辆型号ID,用户自定义
capacityCapacity车辆承载
weightdouble装载重量,单位:千克。精度:保留小数点后4位
volumedouble装载体积,单位:立方米。精度:保留小数点后4位
countdouble装载数量,精度:保留小数点后四位。重量、体积、数量三个维度至少填写一个,车和货的维度保持一致
perDistanceUnitPricedouble车辆每公里行驶成本,取值必须大于0,单位:元/公里
perTimeUnitPricedouble车辆每单位时间行驶成本,取值必须大于0,单位:元/分钟
fixedCostdouble车辆出车固定成本,只要使用该车辆就会产生的固定成本,单位:元,默认值为0
waitingCostdouble车辆等待成本,单位:元/分钟,默认值为0
averageVelocitydouble平均车速,取值必须在0到120之间,单位:千米/小时,distanceType为STRAIGHT时,该参数必填
maxVelocitydouble最大行驶速度,取值必须在0到120之间,且必须大于平均车速,单位:千米/小时
serviceJobsList<ServiceJob>网点信息列表
serviceJobIdString 网点ID,用户自定义参数
locationLocationPoint网点坐标
latitudedouble纬度
longitudedouble经度
serviceStayDurationdouble网点停留时间,取值必须大于0,单位:分钟,默认值为0
demandCapacity网点待配送货物的量
weightdouble装载重量,单位:千克。精度:保留小数点后4位
volumedouble装载体积,单位:立方米。精度:保留小数点后4位
countdouble装载数量,精度:保留小数点后四位。重量、体积、数量三个维度至少填写一个,车和货的维度保持一致
serviceTimeWindowsList<TimeWindow>网点可配送的时间段列表
startTimeint起始时间,单位为分钟,取值范围大于0 。例如,上午10点30分的取值为630
endTimeint结束时间,单位:分钟,取值范围大于1
priorityint订单优先级,取值范围必须为不小于1,不大于10,数字越小代表优先级越高;在有订单分配不了的场景下,会优先将高优先级的订单分配到车辆上,不影响分配的路线顺序
请求参数示例
{
"orderType" : "FAST_ORDER",
"depots" : [ {
"depotId" : "K00061",
"location" : {
"latitude" : 31.223188,
"longitude" : 121.52481
},
"depotTimeWindow" : {
"startTime" : 1,
"endTime" : 1440
},
"vehicleGroups" : [ {
"vehicleTypeId" : "GB01",
"vehicleModelId" : "model_test_1",
"vehicleCount" : 0,
"returnToDepot" : 1,
"departureLocationKey" : "vid"
} ]
} ],
"vehicleModels" : [ {
"vehicleModelId" : "model_test_1",
"capacity" : {
"weight" : 1000.0,
"volume" : 1000.0,
"count" : 1000.0
},
"perDistanceUnitPrice" : 12.22
} ],
"serviceJobs" : [ {
"serviceJobId" : "K00069",
"location" : {
"latitude" : 31.342084,
"longitude" : 121.573599
},
"demand" : {
"weight" : 2.207111693390443,
"volume" : 3.8840549512697033,
"count" : 4.8551923581517435
}
}, {
"serviceJobId" : "K00182",
"location" : {
"latitude" : 31.220752,
"longitude" : 121.52566
},
"demand" : {
"weight" : 3.0989421987729773,
"volume" : 1.6144996971516927,
"count" : 1.8090134817520878
}
}, {
"serviceJobId" : "K00062",
"location" : {
"latitude" : 31.365328,
"longitude" : 121.539487
},
"demand" : {
"weight" : 4.727135459494827,
"volume" : 4.602548940778766,
"count" : 1.110623183652399
}
}, {
"serviceJobId" : "K00183",
"location" : {
"latitude" : 31.22024,
"longitude" : 121.52778
},
"demand" : {
"weight" : 3.365714294602743,
"volume" : 2.6229139289786114,
"count" : 1.9201073132038213
}
}, {
"serviceJobId" : "K00180",
"location" : {
"latitude" : 31.225175,
"longitude" : 121.558869
},
"demand" : {
"weight" : 2.9600987270688313,
"volume" : 1.2012063026626216,
"count" : 3.432207012035625
}
}, {
"serviceJobId" : "K00060",
"location" : {
"latitude" : 31.347316,
"longitude" : 121.56958
},
"demand" : {
"weight" : 2.9088654518330626,
"volume" : 4.120295290877481,
"count" : 2.671981558589062
}
}, {
"serviceJobId" : "K00181",
"location" : {
"latitude" : 31.23258,
"longitude" : 121.54574
},
"demand" : {
"weight" : 1.6721972680453945,
"volume" : 1.620907864387771,
"count" : 1.1237156498270244
}
}, {
"serviceJobId" : "K00065",
"location" : {
"latitude" : 31.340173,
"longitude" : 121.58671
},
"demand" : {
"weight" : 4.138287269930849,
"volume" : 4.5780982348991985,
"count" : 1.3093525836197402
}
}, {
"serviceJobId" : "K00186",
"location" : {
"latitude" : 31.22246,
"longitude" : 121.52088
},
"demand" : {
"weight" : 2.3432535457625385,
"volume" : 4.626574667998128,
"count" : 3.2797455946996115
}
}, {
"serviceJobId" : "K00066",
"location" : {
"latitude" : 31.342107,
"longitude" : 121.57348
},
"demand" : {
"weight" : 2.7934693773000627,
"volume" : 1.7820529837476937,
"count" : 2.5535666940570065
}
}, {
"serviceJobId" : "K00187",
"location" : {
"latitude" : 31.223072,
"longitude" : 121.51817
},
"demand" : {
"weight" : 3.1923031311835337,
"volume" : 2.440653515414892,
"count" : 1.783598073268502
}
}, {
"serviceJobId" : "K00063",
"location" : {
"latitude" : 31.370528,
"longitude" : 121.50831
},
"demand" : {
"weight" : 4.865582462418697,
"volume" : 1.0655422784309128,
"count" : 3.2458459830072908
}
}, {
"serviceJobId" : "K00184",
"location" : {
"latitude" : 31.220493,
"longitude" : 121.52542
},
"demand" : {
"weight" : 4.436569727813067,
"volume" : 3.7319119438055504,
"count" : 1.5775585686735125
}
}, {
"serviceJobId" : "K00064",
"location" : {
"latitude" : 31.36352,
"longitude" : 121.53651
},
"demand" : {
"weight" : 3.8366471116198957,
"volume" : 2.9529118446204783,
"count" : 1.8411913701240992
}
}, {
"serviceJobId" : "K00185",
"location" : {
"latitude" : 31.21723,
"longitude" : 121.51927
},
"demand" : {
"weight" : 4.925196589478421,
"volume" : 1.7050272176626118,
"count" : 2.9264554273667587
}
} ]
}
返回参数示例
{
"id" : "8b664a457cdd42ec871e8344368c5d79",
"status": "RUNNING",
"errorCode": "",
"errorMessage": ""
}
服务状态码
返回码定义常见原因
200返回成功服务请求正常召回
400请求失败请求参数不合法,请按照返回提示修改参数
401未鉴权ak不合法或者账号未开通相应权限
403禁止未开通白名单,请前往反馈工单联系我们。
503服务不可用服务异常,请前往反馈工单联系我们。
500内部服务错误服务异常,请前往反馈工单联系我们。
排线结果还原地图服务说明

1、智能调度排线结果的前端 SDK API:结合智能调度算法API使用,便于客户能够在自己的系统中快速集成智能调度排线结果展示的能力。

排线结果SDK API说明

2、排线结果地图展示:用于单次任务线路结果展示,临时使用,下载下方文档后完善 taskId 与 serveAK 信息保存后即可使用。

结果展示示例文档下载

修改配置

上一篇

使用准备

下一篇

快速排单查询

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