大点位排线服务 最后更新时间: 2024年11月22日

URL

https://tsapi.amap.com/v1/logistics/async/scheduling?key=<用户key>&comCipher=1

请求方式

POST

Content-Type

application/json

参数名（放url上）

类型

含义

规则说明

是否必须

缺省值

key

string

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

无

comCipher

int

数据加密

0为不加密，1为加密

否

0

参数名

类型

含义

规则说明

是否必须

缺省值

reqId

string

请求id

1-32位大小写字母和数字

是

无

sortRule

int

排线排序方式

0：距离最短

1：时间最短

否

0

routeOption

int

算路选项

算路时的可选择策略

0: 无偏好，综合最优

1: 不走高速

2: 避免收费

否

0

considerWaiting

int

考虑等待时间

排线时是否考虑因时间窗导致的等待时间

0：不考虑

1：考虑

否

0

deliveryCapacity

int

配送能力

0：机动车

1：非机动车

是

0

isBack

int

是否回到起点

0：回仓，回到起点（指路线排序后需要回到起点位置）

1：任意点结束（可指定终点）

否

1

departureTime

int

未来出发时间

1.未来出发时间将用于未来预测ETA矩阵计算，预估未来时刻的路线耗时、距离。

2.单位：秒级时间戳

3.必须晚于当前时间，只支持未来6天

4.只有机动车支持未来时间。deliveryCapacity=0时生效

否

无

infiniteVehicle

int

车辆数量限制

0：无限车辆

1：有限车辆

是

1

balanceDimension

list<int>

均衡维度

1：时间，目前仅支持时间维度，传数组

例：[1]

否

considerAggregation

int

是否考虑聚集性

是否考虑聚集性，

0（不考虑）

1（考虑）

默认0

否

0

depots

jsonarray

仓库信息

1、仓库，即配送起点

2、支持多仓库，可上传多个仓库数组

location

string

仓库坐标

经度在前，纬度在后，经度和纬度用","分隔，精确到小数点后6位及以上

是

无

vehicleGroups

jsonarray

车辆组信息

该起点的车辆数组

deliveryType

int

配送方式

deliveryCapacity=0时，本字段可填写：

0：驾车配送

1：货车配送（deliveryType=1时，下面vehicleModels才会生效）

deliveryCapacity=1时，本字段可填写：

2：步行配送

3：自行车配送

4：电动自行车配送

是

0

vehicleGroupId

string

车辆组ID

用户自定义参数，用来唯一标识该车辆数组

否

无

vehicleModelId

string

车辆型号ID

用户自定义参数（deliveryType=1时，参数必填）,最大128字符

否

无

vehicleCount

int

该（型号）车数量

若infiniteVehicle=1：直接填写车辆数量的数字

注意：单次请求车辆数量总和不得超过50，如有需要可以在infiniteVehicle选择“无限车”

若infiniteVehicle=0：此字段可不填/填0

否

1

capacity

jsonobject

容量

车辆容量（与points.demand对应）

否

无

weight

double

装载容量

单位：千克

否

无

volume

double

装载体积

单位：立方米

否

无

count

int

装载数量

否

无

famiPointIndexes

jsonarray

熟悉点位

车辆的熟悉点坐标索引，对应servicePoints中的配送点序号，在infiniteVehicle=0时无效。

示例：[2,3,6,8,25]

否

无

maxDistance

double

车辆最大行驶里程

一次配送任务中，车辆最大行驶里程，单位:米，大于0，不传代表没有限制

否

无

maxTime

double

车辆最长行驶时间

一次配送任务中，车辆最长行驶时间（对应返回中的timeInclude），单位:分钟，大于0，不传代表没有限制

否

无

startTime

int

车辆最早出发时间

相对当日0点的时间偏移（单位：分钟），默认值为0

否

0

endTime

int

车辆最晚到达时间

相对当日0点的时间偏移（单位：分钟），默认无限大

否

无限大

endLocation

string

车辆终点坐标

当isBack=1时，指定车辆以该点为结束点。

需与下方servicePoints内该点location输入相同值。

否

无

vehicleModels

jsonarray

车辆型号信息

当deliveryType=1时，此数组必填

vehicleModelId

string

车辆型号ID

与vehicleGroups.vehicleModelId对应，即本组车辆型号信息为此车辆型号ID的对应数据，最大128字符

是

无

size 

int

车辆大小

高德此分类依据国标

1：微型车，2：轻型车（默认值），3：中型车，4：重型车

是

2

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

servicePoints

jsonarray

配送点信息

配送点规则：

1、骑行、驾车、货车单次最多可以传入50-2000个配送点，至少传入2个配送点；

2、配送点是指除去起点外的配送点

location

string

配送点坐标

经度在前，纬度在后，经度和纬度用","分隔，精确到小数点后6位及以上

是

无

timeWindow

string

时间窗

时间窗信息，相对当日0点的时间偏移（单位：分钟）

例：480,720,780,1320 代表两个时间窗 “480,720”，“780,1320”

否

无

serviceTime

int

配送点服务时长

配送点所需的服务停留时长，单位：分钟

否

0

name

string

配送点poi名称

最大64字符

否

无

demand

jsonobject

需求量

网点待配送货物的量（与vehicleGroups.capacity对应）

否

无

weight

double

需求容量

单位：千克

否

无

volume

double

需求体积

单位：立方米

否

无

count

int

需求数量

否

无

参数 

类型 

说明 

errcode

int

错误码

errmsg

string

错误信息

URL

https://tsapi.amap.com/v1/logistics/async/scheduling/query?key=<用户key>&comCipher=1

请求方式

GET

参数名（放在url上）

类型

含义

规则说明

是否必须

缺省值

key

string

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

无

comCipher

int

数据加密

0为不加密，1为加密

否

0

reqId

string

请求id

1-32位大小写字母和数字

是

无

参数 

类型 

说明 

errorcode

int

错误码，10000为成功。23000表示正在处理中

errmsg

string

错误信息说明

data

jsonarray

结果数据，若开启加密则为加密后的byte[]，不开启加密则为jsonarray

count

int

总路线条数

depotLocation

string

仓库坐标（起点坐标）

depotIndex

int

仓库序列号，按照仓库输入顺序从1开始递增

totalDistance

int

该仓车辆总行驶距离，单位：米

totalTime

int

该仓车辆总行驶时间，单位：分钟

timeAll

int

该仓车辆总耗时（包括路程耗时、因时间窗导致的等待耗时、服务耗时），单位：分钟

loading

jsonobject

仓库车辆总装载率

weight

string

容量装载率，仓库装载总容量/仓库运输车辆总容量，如"800/1000"

volume

string

体积装载率，仓库装载总体积/仓库运输车辆总体积

count

string

数量装载率，仓库装载总数量/仓库运输车辆总数量

routes

jsonarray

车辆分配线路方案

distance

int

该路线车辆总行驶距离，单位：米

time

int

该路线车辆总行驶时间，单位：分钟

timeInclude

int

该路线车辆总耗时（包括路程耗时、因时间窗导致的等待耗时、服务耗时），单位：分钟

deliveryType

string

配送方式

vehicleGroupId

string

该路线使用的车辆信息ID

vehicleModelId

string

该路线使用的车辆型号ID

loading

jsonobject

车辆装载率

weight

string

容量装载率，车辆装载容量/车辆总容量，如"800/1000"

volume

string

体积装载率，车辆装载体积/车辆总体积

count

string

数量装载率，车辆装载数量/车辆总数量

queue

jsonarray

配送次序，从1开始递增

startIndex

int

坐标序列号，仓库的序列号为0，points序列号按照点位输入顺序从1开始依次递增。

startPoint

string

路段起点对应的经纬度

endIndex

int

坐标序列号，仓库的序列号为0，points序列号按照点位输入顺序从1开始依次递增。

endPoint

string

路段终点对应的经纬度

endName

string

路段终点点位名称

distance

int

路段路径距离，单位米

duration

int

路段预计耗时，单位分钟

scheduleTime

int

默认车辆时间窗起始时间为0，预计到达end点的耗时（包括因时间窗导致的等待时间、服务耗时），单位分钟

unassignedNodes

jsonarray

因约束未分配的节点