AI
产品服务
解决方案
文档与支持
定价

所有文档

智能配载服务

更新时间: 2026/03/20 16:14
智能配载计算
下载开发文档
API服务地址

https://api.map.baidu.com/ros/v1/bin_packing/task/create
// POST请求

请求参数
参数名称参数类型是否必须参数说明

palletInfos

List<ExternalPalletInfo>

true

商品列表

palletType

String

true

商品型号, 订单号不填,商品型号要唯一

palletName

String

false

商品名称

orderId

String

false

订单Id,,订单id一旦填写需要全部填写,不可有的为空;,如果订单id存在,需要保证商品型号+订单id是唯一的;

remarks

String

false

备注

count

Int

true

商品数量,必须大于0

length

Double

true

商品长度,必须大于0,单位m

width

Double

true

商品宽度,必须大于0,单位m

height

Double

true

商品高度,必须大于0,单位m

weight

Double

true

商品重量,必须大于0,毛重(含包装),单位kg

loadLevel

Int

false

承重等级,取值范围1-10,数字越小代表越承受力越弱,按数字大小进行排序,每个货品的承重级别必须<=对应的下层货品的承重级别;,不填写默认0,没有承重限制,可以随意摆放;,当需用到“重不压轻”约束时,该参数为必填

canStack

Boolean

false

是否允许非同类商品堆叠,默认为是;注:同类商品默认是可以堆叠的,若不可堆叠,可传多个商品型号。

onlyBottom

Boolean

false

是否允许只堆叠在最底层,非必须,默认否

canRotateInVertical

Boolean

false

是否允许立放时旋转,只能横向旋转,不能放倒,默认允许。

supportRatioInVertical

Double

false

立放时最大悬空比,取值0-1之间,默认0.8,计算方式=接触面积/底面积;,例:悬空比等于1,表示不可以有悬空,完全支撑;

maxStackLayer

Int

false

最大堆叠层数,指的是该商品在其垂直方向的最大堆叠数量要求,不允许小数据点,默认0, 即无限制

loadSequence

Int

false

指定空间顺序,数字越小优先级越高,越优先装载,更适用于容器类型为1,由里往外码放类型的容器;,当承重级别越小,优先满足承重级别约束;

binInfos

List<ExternalBinInfo>

true

容器列表

binName

String

false

容器名称,不能重复

remarks

String

false

备注

count

Int

true

可用容器数量,必须大于0

outerLength

Double

false

容器外径长度,单位m,必须大于0

outerWidth

Double

false

容器外径宽度,单位m,必须大于0

outerHeight

Double

false

容器外径高度,单位m,必须大于0

selfWeight

Double

false

容器自身重量,单位kg,必须大于0

innerLength

Double

true

容器内径长度,单位m,必须大于0

innerWidth

Double

true

容器内径宽度,单位m,必须大于0

innerHeight

Double

true

容器内径高度,单位m,必须大于0

maxLoad

Double

true

容器最大载重 ,单位kg,必须大于0

maxHeight

Double

false

容器可装载的最大高度,单位m,仅支持箱式(即容器类型2)

taskName

String

true

任务名称

smallerOnTop

Boolean

false

承重约束-大不压小,默认false,以体积维度

lighterOnTop

Boolean

false

承重约束-重不压轻,默认false,以承重等级为维度;

binStyle

Int

true

容器类型,1. 厢式容器,码货方向由里往外,2. 箱/拖盘式容器,码货方向由底往上,单次只能传输一种容器类型;

placeDirection

Int

true

摆放方向,1:从底至上摆放,如托盘,2:从窄边侧,从里至外,如集装箱、车厢;

请求参数填写示例
{
"taskName":"test_bin_01",
"binStyle":2,
"placeDirection":1,
"palletInfos":[
{
"palletName":"palletName1",
"palletType":"palletType1",
"count":6,
"length":2,
"width":1,
"height":1,
"weight":1
},
{
"palletName":"palletName2",
"palletType":"palletType2",
"count":1,
"length":2,
"width":2,
"height":2,
"weight":2
}
],
"binInfos":[
{
"binName":"binName1",
"count":1,
"maxLoad":100,
"innerLength":3,
"innerWidth":3,
"innerHeight":3
}
]
}
返回参数
参数名称参数性质参数说明

taskId

String

任务Id

服务状态码
返回码定义常见原因

200

返回成功

服务请求正常召回

400

请求失败

请求参数不合法,请按照返回提示修改参数

401

未鉴权

ak不合法或者账号未开通相应权限

403

禁止

未开通白名单,请前往反馈工单联系我们。

503

服务不可用

服务异常,请前往反馈工单联系我们。

500

内部服务错误

服务异常,请前往反馈工单联系我们。

上一篇

使用准备

下一篇

智能配载查询

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