插单排线服务最后更新时间: 2024年12月03日

产品介绍

物流配送线路规划共有两种主要模式：整体线路排线、新增点排线；

整体路线排线当前由物流排线接口支持实现，该模式多适用于接受路线及配送点有变化的排线场景；

新增点排线则适用于固定路线与配送点的场景下，解决新增点位的插入问题。

针对前期客户通过排线接口算出的点位顺序/客户自己既有的点位顺序，在保证配送点送货顺序不变的情况下，将新增配送点（本期仅支持1个点）添加到现有线路上，共有分两步实现：

计算、选择离该点最近的线路
计算该点插入原线路的位置（哪两点之间）

场景描述

场景一：新增点位，客户自己选定该点要插入的线路；本接口支持将新点位插入选定的线路中（插入到线路上某两点之间），使整体点位排序距离最短/时间最短

场景二：新增点位，本接口根据新点位位置自动安排到最近的送货线路上，并将新点位插入现有的线路中（插入到线路上某两点之间），使整体点位排序距离最短/时间最短

*最近送货线路定义：在给定的若干线路中，离新增点位最近的点位所在的线路

请求地址

URL	https://tsapi.amap.com/v1/logistics/route/scheduling/insert?key=？
请求方式	POST

特别注意：该接口是物流API服务收费接口，您如果申请试用或者正式应用都请通过工单系统提交商务合作类工单进行沟通。

请求参数

参数名			类型	含义	规则说明	是否必须	缺省值
key			string	请求服务权限标识	用户在高德地图官网申请Web服务API类型KEY	必填	无
isOverload			string	是否允许超过最大装载	0 允许，1不允许	是	无
routes			jsonarray	原配送路线集（最大支持传入20条线）		是	无
	vehicle		jsonobject	车辆信息
		deliveryType		配送方式	0：驾车配送 1：货车配送（车辆型号信息必填）	否	0
		serviceTIme	int	车辆服务时长	车辆服务时长（单位：分钟），不传则不限制	否	无
		count	int	数量	数量（与配送点需求数量对应生效），不传则无限制	否	无
		volume	double	体积	体积（与配送点体积对应生效），不传则无限制，最多3位小数	否	无
		weight	double	容量	容量（与配送点需求数量对应生效），不传则无限制，最多3位小数	否	无
	vehicleModel		jsonobject	车辆型号	当车辆类型为货车时，vehicleModel必填	否	无
		size	int	车辆大小	高德此分类依据国标 1：微型车，2：轻型车（默认值），3：中型车，4：重型车	是	无
		height	double	车辆高度	单位米，取值[0 – 25.5]米，默认 1.6 米，会严格按照填写数字进行限行规避，请按照车辆真实信息合理填写。	否	1.6
		width	double	车辆宽度	单位米，取值[0 – 25.5]米，默认 2.5 米，会严格按照填写数字进行限行规避，请按照车辆真实信息合理填写。	否	2.5
		load	double	车辆总重	单位吨，取值[0 – 200]吨，默认 0.9 吨，会严格按照填写数字进行限行规避，请按照车辆真实信息合理填写。总重的含义是核定载重加上车辆自重的总质量。	否	0.9
		weight	double	货车核定载重	单位吨，取值[0 – 200]吨，默认 10 吨，会严格按照填写数字进行限行规避，请按照车辆真实信息合理填写。核定载重的含义是可装载货物的最大重量。	否	10
		axis	int	车辆轴数	单位个，取值[0 –255]个，默认 2个轴，会严格按照填写数字进行限行规避，请按照车辆真实信息合理填写。	否	2
	points		jsonarray	原配送点信息集（单条线最多200点）	是	无
		id	string	原配送点ID集	点位ID是自定义内容，最大32字符	否	无
		location	string	原配送点坐标	经度在前，纬度在后，经度和纬度用","分隔，精确到小数点后6位及以上	是	无
		count	int	需求数量	网点待配送货物的量（与车载数量对应），不填默认无限制	否	无
		volume	double	需求体积	网点待配送货物的量（与车载体积对应），不填默认无限制	否	无
		weight	double	需求容量	网点待配送货物的容量（与车容量对应），不填默认无限制	否	无
	distances		string	原配送点间距离集	按照顺序输入每两点）之间的距离，单位米，以“,”分隔，单值为int类型，如100,30。仅申请用户可不传	是	无
	durations		string	原配送点间耗时集	按照顺序输入每两点之间的耗时，单位分钟，以“,”分隔，单值为int类型，如20,5。仅申请用户可不传	是	无
insertPoints			jsonarray	新增配送点信息		是	无
	id		string	配送点ID	点位ID是自定义内容，最大32字符	否	无
	location		string	配送点坐标	经度在前，纬度在后，经度和纬度用","分隔，精确到小数点后6位及以上	是	无
	count		int	需求数量	网点待配送货物的量（与车载对应生效），最多3位小数	否	无
	volume		double	需求体积	网点待配送货物的量（与车载体积对应），不填默认无限制	否	无
	weight		double	需求容量	网点待配送货物的容量（与车容量对应），不填默认无限制	否	无

返回结果