快速排单计算 | 百度地图API SDK

所有文档

智能调度快速排单服务

服务概览

快速开始

使用准备

接口文档

服务功能

快速排单计算快速排单查询

相关资料

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

更新时间: 2026/03/20 16:12

快速排单计算

下载开发文档

API服务地址

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

请求参数

字段名称				参数类型	必填	参数说明
字段名称	返回参数2	返回参数3	返回参数4	参数类型	必填	参数说明
orderType				String	是	ACCURATE_ORDER：精准排单（支持不高于200个待配送网点的排单计算，采用真实的导航距离的方式进行计算，计算结果精准
depots				List<FastOrderDepot>	是	仓库信息，目前只支持单仓模式
	depotId			String	是	仓库ID，用户仓库自定义参数
	location			LocationPoint	是	仓库坐标
		latitude		double	是	纬度
		longitude		double	是	经度
	depotTimeWindow			TimeWindow	否	时间窗信息，精准排单场景按照仓库出发时间startTime的预测路况进行排单计算，建议设置实际的出仓时间来提升预估行驶里程及时间的准确度
		startTime		int	是	起始时间，单位为分钟，取值范围大于0 。（例如：6点15分，取值为375）
		endTime		int	是	结束时间，单位为分钟，取值范围大于1
	vehicleGroups			List<FastOrderVehicleGroup>	是	该仓库的车辆组信息
		vehicleTypeId		String	是	车辆类型ID，枚举，目前支持GB01（货车，车辆长宽高6m2m3m）、SMALL（货车，车辆长宽高4m2m2m）、NORMAL（小客车）、ELECBICYCLE（两轮电动车）、BICYCLE（自行车）。该信息用于道路货车限行规避，一个车辆类型会对应一个或多个型号的车辆，由用户自行决定车辆型号与车辆类型的映射关系
		vehicleModelId		String	是	车辆型号ID，用户自定义参数
		vehicleCount		int	是	该型号车数量，不小于0，0代表没有限制
		maxVisited		int	否	车辆允许运送的最大订单数量，不小于0，0代表没有限制
		maxRunDistance		int	否	车辆最大行驶距离，单位:米，不小于0，0代表没有限制
		maxRunTime		int	否	车辆最大行驶时间，单位:分钟，不小于0，0代表没有限制
		returnToDepot		int	否	是否回仓，1为回仓，2为不回仓（不回仓的时候，默认车辆停留在配送的最后一个点），默认回仓
		departureLocationKey		String	是	车辆起始坐标对应key
		departureLocation		LocationPoint	否	车辆起始坐标，不填默认为仓库坐标
			latitude	double	是	纬度
			longitude	double	是	经度
		startTime		int	否	车辆起始时间，单位为分钟，取值范围大于0 。出发点为仓库时建议与出仓时间保持一致
		endTime		int	否	车辆结束时间，单位为分钟，取值范围大于1
vehicleModels				List<VehicleModel>	是	车辆型号信息
	vehicleModelId			String	是	车辆型号ID，用户自定义
	capacity			Capacity	是	车辆承载
		weight		double	否	装载重量，单位：千克。精度：保留小数点后4位
		volume		double	否	装载体积，单位：立方米。精度：保留小数点后4位
		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<ServiceJob>	是	网点信息列表
	serviceJobId			String	是	网点ID，用户自定义参数
	location			LocationPoint	是	网点坐标
		latitude		double	是	纬度
		longitude		double	是	经度
	serviceStayDuration			double	否	网点停留时间，取值必须大于0，单位：分钟，默认值为0
	demand			Capacity	是	网点待配送货物的量
		weight		double	否	装载重量，单位：千克。精度：保留小数点后4位
		volume		double	否	装载体积，单位：立方米。精度：保留小数点后4位
		count		double	否	装载数量，精度：保留小数点后四位。重量、体积、数量三个维度至少填写一个，车和货的维度保持一致
	serviceTimeWindows			List<TimeWindow>	否	网点可配送的时间段列表
		startTime		int	否	起始时间，单位为分钟，取值范围大于0 。例如，上午10点30分的取值为630
		endTime		int	否	结束时间，单位：分钟，取值范围大于1
	priority			int	否	订单优先级，取值范围必须为不小于1，不大于10，数字越小代表优先级越高；在有订单分配不了的场景下，会优先将高优先级的订单分配到车辆上，不影响分配的路线顺序

请求参数示例



        {
          "orderType" : "ACCURATE_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 信息保存后即可使用。
结果展示示例文档下载