开发 物流服务API 开发指南 排线调度

异步智能分区服务 最后更新时间: 2025年08月18日

产品介绍

智能分区接口考虑地址位置聚集,工作时长均衡,订单量均量等不同维度的需求进行自定义分区,从而寻求满足自定义约束条件的最优分区。

本服务主要解决单起点、多车辆、多配送点(最多20000点)的场景,本服务为异步服务。最大可支持20000点的智能分区。

智能分区请求接口

请求地址

URL

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

Content-Type

application/json

请求方式

POST

注意

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

请求参数

参数(放body中)

类型

含义

规则说明

必填

默认值

reqId

string

请求id

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

areaNum

int

分区数量

需要划分的区域数量

支持2-100

partitionType

int

分区类型

1:考虑容量分区

(默认,考虑地理位置聚集和任务均衡)

2:不考虑容量分区(只考虑地理位置聚集)

1

depotLocation

string

仓库坐标

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

balanceDimension

list<int>

均衡维度

1:任务时长; 

2:容量均衡;

3:数量均衡 ;

4:体积均衡

均衡维度是指:分区后,每个区总的任务时长相对均衡,或者订单量(数量/重量/体积)相对均衡

servicePointsCompress

string

string

配送点压缩,servicePoints字段的压缩格式(servicePoints 超过1000个时建议压缩,servicePoints和servicePointsCompress至少传一个)

压缩方式:json使用gzip压缩为二进制后,使用base64转为文本

servicePoints

jsonarray

配送点信息

配送点规则:

3~2w个配送点

location

string

配送点坐标

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

name

string

配送点poi名称

最大64字符

demand

jsonobject

需求量

weight

double

需求容量

单位:千克

volume

double

需求体积

单位:立方米

count

int

需求数量

单位:件

vehicles

jsonarray

车辆信息

分区类型(partitionType)为1时,必传

vehicleGroupId

string

车辆(组)ID

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

注:车辆组id既可以表示车牌号id, 也可以灵活应用于车型id,用户可自定义参数。

vehicleCount

int

相同类型车辆数量

用以表示相同类型的车辆数量

如果车辆组代表车牌号,vehicleCount=1

如果车辆组代表车型,vehicleCount=具体数量

capacity

weight

double

容量

单位:千克

volume

double

体积

单位:立方米

count

int

数量

单位:件

请求示例

curl --location 'tsapi.amap.com/v1/logistics/async/regionPartition?key=xxx' \
--header 'Content-Type: application/json' \
--data '{
    "areaNum": 4,
    "balanceDimension": [
        1
    ],
    "depotLocation": "120.120227,30.283199",
    "partitionType": 2,
    "reqId": "1247",
    "servicePoints": [
        {
            "location": "120.122529,30.286014",
            "name": "服务点1"
        },
        {
            "location": "120.111846,30.276135",
            "name": "服务点2"
        },
        {
            "location": "120.107098,30.288399",
            "name": "服务点3"
        },
        {
            "location": "120.132455,30.297799",
            "name": "服务点4"
        },
        {
            "location": "120.115667,30.279475",
            "name": "服务点5"
        },
        {
            "location": "120.10784,30.29134",
            "name": "服务点6"
        },
        {
            "location": "120.119615,30.281082",
            "name": "服务点7"
        },
        {
            "location": "120.122287,30.28367",
            "name": "服务点8"
        },
        {
            "location": "120.125601,30.283864",
            "name": "服务点9"
        },
        {
            "location": "120.126224,30.281324",
            "name": "服务点10"
        },
        {
            "location": "120.126152,30.279039",
            "name": "服务点11"
        },
        {
            "location": "120.106443,30.282758",
            "name": "服务点12"
        },
        {
            "location": "120.118332,30.280043",
            "name": "服务点13"
        },
        {
            "location": "120.117011,30.285845",
            "name": "服务点14"
        },
        {
            "location": "120.12952,30.282059",
            "name": "服务点15"
        },
        {
            "location": "120.12595,30.281787",
            "name": "服务点16"
        },
        {
            "location": "120.135859,30.286092",
            "name": "服务点17"
        },
        {
            "location": "120.11321,30.278865",
            "name": "服务点18"
        },
        {
            "location": "120.13689,30.296581",
            "name": "服务点19"
        },
        {
            "location": "120.110692,30.288594",
            "name": "服务点20"
        },
        {
            "location": "120.115045,30.29328",
            "name": "服务点21"
        },
        {
            "location": "120.124557,30.282778",
            "name": "服务点22"
        },
        {
            "location": "120.132129,30.295008",
            "name": "服务点23"
        },
        {
            "location": "120.121211,30.280923",
            "name": "服务点24"
        },
        {
            "location": "120.105025,30.280002",
            "name": "服务点25"
        },
        {
            "location": "120.121871,30.280201",
            "name": "服务点26"
        },
        {
            "location": "120.111043,30.285338",
            "name": "服务点27"
        },
        {
            "location": "120.130327,30.272032",
            "name": "服务点28"
        },
        {
            "location": "120.131203,30.280975",
            "name": "服务点29"
        },
        {
            "location": "120.130204,30.27908",
            "name": "服务点30"
        },
        {
            "location": "120.108543,30.281608",
            "name": "服务点31"
        },
        {
            "location": "120.115678,30.279392",
            "name": "服务点32"
        },
        {
            "location": "120.131858,30.268784",
            "name": "服务点33"
        },
        {
            "location": "120.103492,30.27866",
            "name": "服务点34"
        },
        {
            "location": "120.123449,30.281951",
            "name": "服务点35"
        },
        {
            "location": "120.124865,30.281053",
            "name": "服务点36"
        },
        {
            "location": "120.126531,30.271635",
            "name": "服务点37"
        },
        {
            "location": "120.136248,30.301355",
            "name": "服务点38"
        },
        {
            "location": "120.133988,30.281476",
            "name": "服务点39"
        },
        {
            "location": "120.108605,30.296156",
            "name": "服务点40"
        },
        {
            "location": "120.116228,30.279042",
            "name": "服务点41"
        },
        {
            "location": "120.121508,30.29556",
            "name": "服务点42"
        },
        {
            "location": "120.129095,30.292194",
            "name": "服务点43"
        },
        {
            "location": "120.126979,30.292323",
            "name": "服务点44"
        },
        {
            "location": "120.11956,30.29318",
            "name": "服务点45"
        },
        {
            "location": "120.117463,30.278302",
            "name": "服务点46"
        },
        {
            "location": "120.128795,30.289161",
            "name": "服务点47"
        },
        {
            "location": "120.134058,30.291064",
            "name": "服务点48"
        },
        {
            "location": "120.122678,30.283495",
            "name": "服务点49"
        },
        {
            "location": "120.107544,30.292133",
            "name": "服务点50"
        },
        {
            "location": "120.121665,30.286526",
            "name": "服务点51"
        },
        {
            "location": "120.12535,30.270291",
            "name": "服务点52"
        },
        {
            "location": "120.129346,30.279442",
            "name": "服务点53"
        },
        {
            "location": "120.124447,30.283074",
            "name": "服务点54"
        },
        {
            "location": "120.123797,30.291408",
            "name": "服务点55"
        },
        {
            "location": "120.135614,30.286745",
            "name": "服务点56"
        },
        {
            "location": "120.115916,30.293803",
            "name": "服务点57"
        },
        {
            "location": "120.120687,30.283508",
            "name": "服务点58"
        },
        {
            "location": "120.124314,30.265768",
            "name": "服务点59"
        },
        {
            "location": "120.11705,30.300014",
            "name": "服务点60"
        },
        {
            "location": "120.120784,30.291568",
            "name": "服务点61"
        },
        {
            "location": "120.114595,30.279513",
            "name": "服务点62"
        },
        {
            "location": "120.1082,30.289668",
            "name": "服务点63"
        },
        {
            "location": "120.116162,30.28513",
            "name": "服务点64"
        },
        {
            "location": "120.132618,30.285017",
            "name": "服务点65"
        },
        {
            "location": "120.118589,30.28987",
            "name": "服务点66"
        },
        {
            "location": "120.125876,30.289428",
            "name": "服务点67"
        },
        {
            "location": "120.129443,30.282713",
            "name": "服务点68"
        },
        {
            "location": "120.113615,30.285065",
            "name": "服务点69"
        },
        {
            "location": "120.105293,30.281405",
            "name": "服务点70"
        },
        {
            "location": "120.118384,30.274102",
            "name": "服务点71"
        },
        {
            "location": "120.11814,30.288374",
            "name": "服务点72"
        },
        {
            "location": "120.121839,30.274526",
            "name": "服务点73"
        },
        {
            "location": "120.124851,30.280884",
            "name": "服务点74"
        },
        {
            "location": "120.10757,30.286286",
            "name": "服务点75"
        },
        {
            "location": "120.113568,30.272864",
            "name": "服务点76"
        },
        {
            "location": "120.122218,30.290447",
            "name": "服务点77"
        },
        {
            "location": "120.130554,30.28702",
            "name": "服务点78"
        },
        {
            "location": "120.103104,30.293379",
            "name": "服务点79"
        },
        {
            "location": "120.117618,30.29262",
            "name": "服务点80"
        },
        {
            "location": "120.103876,30.291828",
            "name": "服务点81"
        },
        {
            "location": "120.121922,30.282658",
            "name": "服务点82"
        },
        {
            "location": "120.133156,30.286029",
            "name": "服务点83"
        },
        {
            "location": "120.124862,30.293622",
            "name": "服务点84"
        },
        {
            "location": "120.120816,30.282205",
            "name": "服务点85"
        },
        {
            "location": "120.121871,30.280016",
            "name": "服务点86"
        },
        {
            "location": "120.121217,30.284923",
            "name": "服务点87"
        },
        {
            "location": "120.114672,30.295989",
            "name": "服务点88"
        },
        {
            "location": "120.118682,30.291589",
            "name": "服务点89"
        },
        {
            "location": "120.131114,30.283419",
            "name": "服务点90"
        },
        {
            "location": "120.122951,30.28492",
            "name": "服务点91"
        },
        {
            "location": "120.131033,30.268014",
            "name": "服务点92"
        },
        {
            "location": "120.121426,30.288331",
            "name": "服务点93"
        },
        {
            "location": "120.116283,30.282757",
            "name": "服务点94"
        },
        {
            "location": "120.123104,30.287056",
            "name": "服务点95"
        },
        {
            "location": "120.128576,30.296698",
            "name": "服务点96"
        },
        {
            "location": "120.111997,30.288005",
            "name": "服务点97"
        },
        {
            "location": "120.118733,30.274618",
            "name": "服务点98"
        },
        {
            "location": "120.109947,30.300205",
            "name": "服务点99"
        },
        {
            "location": "120.118987,30.280481",
            "name": "服务点100"
        }
    ],
    "vehicles": [
        {
            "vehicleCount": 1,
            "vehicleGroupId": "a"
        },
        {
            "vehicleCount": 1,
            "vehicleGroupId": "b"
        },
        {
            "vehicleCount": 1,
            "vehicleGroupId": "c"
        },
        {
            "vehicleCount": 1,
            "vehicleGroupId": "d"
        }
    ]
}'

返回参数

参数

类型

含义

字段类型 

说明 

errcode 

int

返回结果状态码 

errdetail 

string

返回结果描述 

errmsg 

string

返回结果状态码描述 

见附录

智能分区结果查询接口

请求地址

URL

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

请求方式

GET

注意

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

请求参数

参数

类型 

含义

说明 

是否必填 

默认值

key 

string 

开平官网申请

开平官网申请

comCipher

int

数据加密

0不加密(默认);1加密

0

reqId

string

请求id

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

服务示例

curl --location 'tsapi.amap.com/v1/logistics/async/regionPartition/query?reqId=1246&key=xxx'

返回参数

参数

类型

参数说明

errcode

int

错误码

errdetail 

string

返回结果描述

errmsg

string

错误信息

data

object

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

areaNum

int

分区总数

areas

jsonarray

分区信息

index

int

分区序列号,为系统自动编号,从1开始递增;

totalCapacity

object

partitionType=1(考虑分区容量)时,

与异步智能分区接口中的balanceDimension保持一致

weight

double

容量,单位:千克

volume

double

体积,单位:立方米

count

int

数量

num

int

该区点位数

pointIndexes

list

配送点对应传入servicePoints中的索引,如[1,2,3]

vehiclesIndexes

list

分区内车辆序列号[1,2,3]

unassignedIndexes

list

未分配的servicePoints,如[1,2]

附录

序号 

errcode 

errmsg 

状态描述 

问题排查策略 

1

10000 

OK 

请求正常 

请求正常 

2

10001 

INVALID_USER_KEY 

key不正确或过期 

发起请求时,传入的key不正确或者过期 

3

10002 

SERVICE_NOT_AVAILABL E,Solution URL "http://lbs.a map.com/api/webservice/inf o/" 

没有权限使用相应 的服 务或者请求 接口的路径 拼写 错误 

1.没有权限使用相应的服务,例如:申请了WEB定位功能的key,却使用该key访问逆地理编码功能时,就会返回该错误。反之亦然

2.请求接口的路径拼写错误

4

10003 

DAILY_QUERY_OVER_LIMI T,Solution URL "http://lbs.am ap.com/api/webservice/info/" 

访问已超出日访问 量 

日访问量超限,被系统自动封停,第二天0:0 0会自动解封

5

10004 

ACCESS_TOO_FREQUEN T,Solution URL"http://lbs.am ap.com/api/webservice/info/" 

单位时间内访问过 于频 繁 

单位时间内(1分钟)访问量超限,被系统 自 动封停,下一分钟自动解封。 

6

10005 

INVALID_USER_IP 

IP白名单出错,发 送请求的服务器IP 不在IP白名单内 

在LBS官网控制台设置的IP白名单不正确。 白名单中未添加对应服务器的出口IP。可 到"控制台>配置"中设定IP白名单

7

10006 

INVALID_USER_DOMAIN 

绑定域名无效 

为Key绑定的域名无效,需要在官网控制台 重 新设置 

8

10007 

INVALID_USER_SIGNATURE

数字签名未通过验 证 

数字签名未通过。在key控制台中,开启 了"数字签名"功 能,但没有按照指定算法生 成"数字签名

9

10008 

INVALID_USER_SCODE 

MD5安全码未通过 验证 

需要判定key绑定的SHA1,package是否与sd k包里的一致 

10

10009 

USERKEY_PLAT_NOMATCH 

请求key与绑定平 台不 符 

请求中使用的key与绑定平台不符,例如: 申 请的是JS A PI的key,却用来调Web服务 接口 

11

10010 

IP_QUERY_OVER_LIMIT,So lution URL "http://lbs.amap.c om/api/webservice/info/" 

IP访问超限 

未设定IP白名单的开发者使用Key发起请 求, 从单个IP向 服务器发送的请求次数超 出限 制,被系统自动封停

12

10011 

NOT_SUPPORT_HTTPS 

服务不支持https请 求 

服务不支持https请求,如果需要申请支持, 请提交工单联系我们 

13

10012 

INSUFFICIENT_PRIVILEGE S 

权限不足,服务请 求被 拒绝 

由于不具备请求该服务的权限,所以服务被 拒绝

14

10013

USER_KEY_RECYCLED 

Key被删除 

Key被删除后无法正常使用 

15

10014 

QPS_HAS_EXCEEDED_TH E_LIMIT 

QPS超限 

QPS超出限制,超出部分的请求被拒绝。限 流阈值内的请求依旧会正常返回 

16

10015

GATEWAY_TIMEOUT 

受单机QPS限流限 制 

受单机QPS限流限制时出现该问题,建议降 低请求的QPS或在控制台提工单联系我们 

17

10016 

SERVER_IS_BUSY 

服务器负载过高 

服务器负载过高,请稍后再试 

18

10017

RESOURCE_UNAVAILABLE

所请求的资源不可用

所请求的资源不可用 

19

10019

CQPS_HAS_EXCEEDED_THE_LIMIT

使用的某个服务总QPS超限

20

10020

CKQPS_HAS_EXCEEDED_THE_LIMIT 

某个Key使用某个服务接口QPS超出限制

21

10021

CIQPS_HAS_EXCEEDED_THE_LIMIT

来自于同一IP的访问,使用某个服务QPS超出限制

22

10022

CIKQPS_HAS_EXCEEDED_THE_LIMIT 

某个Key,来自于同一IP的访问,使用某个服务QPS 超出限制

23

10023

KQPS_HAS_EXCEEDED_THE_LIMIT 

某个KeyQPS超出限制

24

20000 

INVALID_PARAMS  

请求参数非法  

请求参数的值没有按照规范要求填写。例如,某参数值域范围为[1,3],开发者误填了"4"  

25

20001  

MISSING_REQUIRED_PARAMS  

缺少必填参数  

缺少接口中要求的必填参数  

26

20002  

ILLEGAL_REQUEST  

请求协议非法  

请求协议非法 

27

20003  

UNKNOWN_ERROR  

其他未知错误  

其他未知错误  

28

20004

ID_NOT_FOUND

找不到相应ID

设备id未注册

29

300**  

ENGINE_RESPONSE_DATA_ERROR  

服务响应失败 

出现3开头的错误码,建议先检查传入参数是否正确,若无法解决,请详细描述错误复现信息,提工单给我们 

返回顶部 示例中心 常见问题 智能客服 公众号
二维码