开发者文档开始使用
结果与坐标
每件物品的位置、朝向和装载顺序。
所有位置和尺寸均以 cm 为单位，从货厢的最小角点起算。
坐标
| 坐标轴 | 方向 | 0 点位置 |
|---|---|---|
x | 长度 | 前壁。x = length 处为车门 |
y | 高度 | 地板 |
z | 宽度 | 右壁（站在车门处向内看） |
摆放位置
result.vehicles[].placements[]，每件物品一条：
| 字段 | 内容 |
|---|---|
item_id, instance | 您的物品 ID，以及是其 quantity 中的第几件（1…n） |
x, y, z | 物品摆放后的最小角点 |
length, width, height | 摆放后沿 x、z、y 轴的尺寸 |
orientation, rotated | 物品如何旋转（见下文） |
step | 在该车内的装载顺序，1 表示最先装载 |
{
"item_id": "pallet-eu",
"instance": 2,
"label": "Euro pallet",
"x": 0,
"y": 0,
"z": 120,
"length": 80,
"width": 120,
"height": 140,
"rotated": true,
"orientation": "wlh",
"step": 2,
"weight": 450
}第 2 件欧标托盘位于前壁处（x 0–80），放在地板上，距右壁 z 120–240，水平旋转了 90°。
朝向
您定义的哪条边分别沿 x、z、y 轴：
| 代码 | 含义 |
|---|---|
lwh | 与定义一致 |
wlh | 绕竖直轴旋转 90° |
lhw, hlw | 侧放 |
hwl, whl | 竖立（端面朝下） |
rotation: "upright" 只允许 lwh 和 wlh。fixed 只允许 lwh。
每辆车
| 字段 | 内容 |
|---|---|
items_placed, total_weight | 车内的件数和总重量 |
volume_utilization, weight_utilization | 0–1 |
center_of_gravity | 货物重心的 x、y、z |
axle_loads[] | 各轴载荷。需申请开通（axle_loads） |
未装载
result.unplaced[] 列出未能装下的物品及其 reason。使用 packing_mode: "auto" 时，会先追加车辆（不超过任务上限），仍装不下的物品才会列为未装载。