智能调度排单排线服务 | 百度地图api sdk-凯发k8官方旗舰厅

浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
排单排线计算
下载开发文档
api服务地址

https://api.map.baidu.com/ros/v1/scheduler/problem?ak=您的ak
//post请求

请求参数
参数名称参数类型必填参数说明
scenestypestring算法需要使用的场景类型,场景维度包含网点规模及排单结果路线交叉程度。枚举:large_scale_cluster:大规模聚集性场景,small_scale_cluster:小规模聚集性场景,large_scale_general:大规模通用场景,small_scale_general:小规模通用场景。大规模场景要求网点数在600点以上,小规模场景网点数600点以下。聚集性为路线不交叉,但是成本不一定最低,通用性为路线可能交叉,但是成本最低
matrixidstring路网矩阵id,路网矩阵唯一标识码
lbstypelist路网矩阵类型,枚举。least_time:时间优先,least_distance:距离最短,no_highway:不走高速。 用户可以根据自己场景填写
commitidstring路网矩阵版本id
distancetypestring距离计算方式,枚举。straight:直线距离, travel:导航距离。直线距离计算场景必须设置车辆的平均行驶速度
depotslist仓库信息列表,一期支持单仓
depotidstring仓库id,用户仓库自定义参数
depottimewindowtimewindow时间窗信息,时间约束条件,车辆最早出仓时间和最晚回仓时间
starttimeint起始时间,单位:分钟,取值范围大于0。例如,上午10点30分的取值为630
endtimeint结束时间,单位:分钟,取值范围大于1
vehiclegroupslist该仓库的车辆组信息
vehicletypeidstring车辆类型id,枚举,目前支持gb01(默认车辆长6000mm,宽2100mm,高3000mm)以及small(小轿车,车辆长4000mm,宽2000mm,高2000mm),两种车辆类型的轴重轴数均为2。该信息用于道路货车限行规避,一个车辆类型会对应一个或多个型号的货车,由用户自行决定车辆型号与车辆类型的映射关系
vehiclemodelidstring车辆型号id,用户自定义参数
vehiclecountint该型号车数量,不小于0,0代表没有限制
minvisitedint车辆允许运送的最小订单数量,不小于0,0代表没有限制
maxvisitedint车辆允许运送的最大订单数量,不小于0,0代表没有限制
maxrundistanceint车辆最大行驶距离,单位:米,不小于0,0代表没有限制
maxruntimeint车辆最大行驶时间,单位:分钟,不小于0,0代表没有限制
vehicleskillslist车辆可运输的货物类型列表(车辆具备某种运输能力,如冷冻功能、运输危化品能力等)
returntodepotboolean是否回仓,默认回仓
vehiclemodelslist车辆型号信息
vehiclemodelidstring车辆型号id,用户自定义
capacitystring车辆型号id,用户自定义
weightdouble装载重量,单位:千克。精度:保留小数点后四位
volumedouble装载体积,单位:立方米。精度:保留小数点后四位
countdouble装载数量,精度:保留小数点后四位。重量、体积、数量三个维度至少填写一个,车和货的维度保持一致
perdistanceunitpricedouble车辆每公里行驶成本,取值必须大于0,单位:元/公里
pertimeunitpricedouble/车辆每单位时间行驶成本,取值必须大于0,单位:元/分钟
fixedcostdouble车辆固定损耗成本,单位:元/天,默认值为0
waitingcostdouble车辆等待成本,单位:元/分钟,默认值为0
averagevelocitydouble平均车速,取值必须在0到120之间,单位:千米/小时,distancetype为straight时,该参数必填
maxvelocitydouble最大行驶速度,取值必须在0到120之间,且必须大于平均车速,单位:千米/小时
servicejobslist网点信息列表
servicejobidstring网点id,用户自定义参数
servicestaydurationdouble网点停留时间,取值必须大于0,单位:分钟,默认值为0
demandcapacity网点待配送货物的量
weightdouble装载重量,单位:千克。精度:保留小数点后四位
volumedouble装载体积,单位:立方米。精度:保留小数点后四位
countdouble装载数量,精度:保留小数点后四位。重量、体积、数量三个维度至少填写一个,车和货的维度保持一致
servicetimewindowslist 网点可配送的时间段列表
starttimeint起始时间,单位:分钟,取值范围大于0 。例如,上午10点30分的取值为630
endtimeint结束时间,单位:分钟,取值范围大于1
skillslist需要运输的货物类型列表(车辆需要具备某种运输能力,如冷冻功能、运输危化品能力等)
priorityint订单优先级,取值范围必须为不小于1,不大于10,数字越大代表优先级越高
返回参数
字段名称字段类型备注
idstring排单排线计算任务id
statusstring任务执行状态:running、error
errorcodestring错误码
errormessagestring错误信息
请求参数填写示例
{
"scenestype":"small_scale_general",
"matrixid":"1a72478093ba40519c2fff6e8242a082",
"lbstype":"least_time",
"distancetype":"travel",
"depots":[{
"depotid":"340078493e0a4090b2055e7689626001",
"depottimewindow":{
"starttime":0,
"endtime":1440
},
"vehiclegroups":[{
"vehicletypeid":"gb01",
"vehiclemodelid":"model_test_1",
"vehiclecount":0,
"returntodepot":false
}]
}],
"vehiclemodels":[{
"vehiclemodelid":"model_test_1",
"capacity":{
"weight":1000.0,
"volume":1000.0,
"count":1000.0
},
"perdistanceunitprice":12.22,
"pertimeunitprice":20.0
}],
"servicejobs":[{
"servicejobid":"340078493e0a4090b2055e7689626002",
"demand":{
"weight":3.02,
"volume":3.07,
"count":3.0
}
},{
"servicejobid":"340078493e0a4090b2055e7689626003",
"demand":{
"weight":1.04,
"volume":4.31,
"count":4.0
}
},{
"servicejobid":"340078493e0a4090b2055e7689626004",
"demand":{
"weight":4.03,
"volume":1.98,
"count":4.0
}
}]
}
返回参数示例
{
"id":"8b664a457cdd42ec871e8344368c5d79",
"status":"running",
"errorcode":"",
"errormessage":""
}
服务状态码
返回码定义常见原因
200返回成功服务请求正常召回
400请求失败请求参数不合法,请按照返回提示修改参数
401未鉴权ak不合法或者账号未开通相应权限
403禁止未开通白名单,请前往联系凯发k8官方旗舰厅。
503服务不可用服务异常,请前往联系凯发k8官方旗舰厅。
500内部服务错误服务异常,请前往联系凯发k8官方旗舰厅。

上一篇

使用准备

下一篇

排单排线查询

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

网站地图