智能配载查询 | 百度地图API SDK

所有文档

智能配载服务

服务概览

快速开始

使用准备

接口文档

服务功能

智能配载计算智能配载查询

服务应用

配载结果展示

相关资料

更新日志常见问题资源下载使用指南

更新时间: 2026/03/20 16:14

智能配载查询

下载开发文档

API服务地址

https://api.map.baidu.com/ros/v1/bin_packing/{taskId}
// GET请求

请求参数

参数名称	参数类型	是否必填	参数说明
参数名称	参数类型	是否必填	参数说明
taskId	String	true	任务Id

返回参数

参数名称				参数类型	参数说明
参数名称				参数类型	参数说明
taskName				String	任务名称
binPackingSolution				BinPackingSolution
	count			Integer	数量
	unplacedPallets			List<PalletInfo>	未被放置的商品列表
		orderId		String	订单Id
		palletName		String	商品名称
		palletType		String	商品型号
		remarks		String	备注
		count		Integer	商品数量
		length		Double	商品长度
		width		Double	商品宽度
		height		Double	商品高度
		weight		Double	商品重量
		canStack		Boolean	是否允许非同类商品堆叠；
		onlyBottom		Boolean	是否允许只堆叠在最底层，非必须，默认否
		loadLevel		Integer	承重等级
		maxStackLayer		Integer	最大堆叠数
		canRotateInVertical		Boolean	是否允许立放时旋转
		supportRatioInVertical		Double	立放时最大悬空比
		loadSequence		Int	指定空间顺序，数字越小优先级越高，越优先装载，更适用于容器类型为1，由里往外码放类型的容器；,当承重级别越小，优先满足承重级别约束；
		reason		String	未装载原因
	binSolutions			List<BinSolution>	装箱结果列表
		binName		String	箱体名称
		innerLength		Double	箱体内径长
		innerWidth		Double	箱体内径宽
		innerHeight		Double	箱体内径高
		binType		Integer	箱体类型
		selfWeight		Double	箱体自重
		maxLoad		Double	箱体最大载重
		weightLoadRate		Double	箱体载重率
		volumeLoadRate		Double	箱体体积率
		totalWeight		Double	总重量（kg）
		totalVolume		Double	总体积（立方米）
		totalCountOfPallet		Int	箱子总数量
		packingResultList		List<PackingResult>	箱体内商品列表
			id	String	标记唯一托盘，算法生成
			orderId	String	隶属的订单ID
			palletName	String	商品名称
			palletType	String	商品型号
			x	Double	托盘定位点(x, y, z)
			y	Double
			z	Double
			width	Double	托盘宽，平行于容器宽的边为宽
			height	Double	托盘高，垂直于容器高的边为高
			depth	Double	托盘深，平行于容器长的边为深
			placeMode	String	摆放方式，可为空
id				String	taskId
status				String	任务状态，RUNNING, ERROR, FINISHED, TASK_NOT_FOUND
errorCode				String	错误码
errorMessage				String	错误信息

返回参数示例


{
    "id": "615804c69e80475b83c6e0836e834fd8",
    "status": "FINISHED",
    "errorCode": "",
    "errorMessage": "",
    "binPackingSolution": {
        "count": 1,
        "binSolutions": [
            {
                "binName": "binName1",
                "innerLength": 3.0,
                "innerWidth": 3.0,
                "innerHeight": 3.0,
                "binType": 0,
                "selfWeight": 0.0,
                "maxLoad": 100.0,
                "weightLoadRate": 0.08,
                "volumeLoadRate": 0.7407407407407407,
                "totalWeight": 8.0,
                "totalVolume": 20.0,
                "totalCountOfPallet": 7,
                "packingResultList": [
                    {
                        "id": "7",
                        "orderId": "",
                        "palletName": "palletName2",
                        "palletType": "palletType2",
                        "x": 0.0,
                        "y": 0.0,
                        "z": 0.0,
                        "width": 2.0,
                        "height": 2.0,
                        "depth": 2.0,
                        "weight": 0.0,
                        "placeMode": "立放"
                    },
                    {
                        "id": "6",
                        "orderId": "",
                        "palletName": "palletName1",
                        "palletType": "palletType1",
                        "x": 2.0,
                        "y": 0.0,
                        "z": 0.0,
                        "width": 1.0,
                        "height": 1.0,
                        "depth": 2.0,
                        "weight": 0.0,
                        "placeMode": "立放&水平旋转"
                    },
                    {
                        "id": "5",
                        "orderId": "",
                        "palletName": "palletName1",
                        "palletType": "palletType1",
                        "x": 0.0,
                        "y": 2.0,
                        "z": 0.0,
                        "width": 2.0,
                        "height": 1.0,
                        "depth": 1.0,
                        "weight": 0.0,
                        "placeMode": "立放"
                    },
                    {
                        "id": "4",
                        "orderId": "",
                        "palletName": "palletName1",
                        "palletType": "palletType1",
                        "x": 2.0,
                        "y": 0.0,
                        "z": 1.0,
                        "width": 1.0,
                        "height": 1.0,
                        "depth": 2.0,
                        "weight": 0.0,
                        "placeMode": "立放&水平旋转"
                    },
                    {
                        "id": "3",
                        "orderId": "",
                        "palletName": "palletName1",
                        "palletType": "palletType1",
                        "x": 0.0,
                        "y": 2.0,
                        "z": 1.0,
                        "width": 2.0,
                        "height": 1.0,
                        "depth": 1.0,
                        "weight": 0.0,
                        "placeMode": "立放"
                    },
                    {
                        "id": "2",
                        "orderId": "",
                        "palletName": "palletName1",
                        "palletType": "palletType1",
                        "x": 0.0,
                        "y": 0.0,
                        "z": 2.0,
                        "width": 2.0,
                        "height": 1.0,
                        "depth": 1.0,
                        "weight": 0.0,
                        "placeMode": "立放"
                    },
                    {
                        "id": "1",
                        "orderId": "",
                        "palletName": "palletName1",
                        "palletType": "palletType1",
                        "x": 2.0,
                        "y": 0.0,
                        "z": 2.0,
                        "width": 1.0,
                        "height": 1.0,
                        "depth": 2.0,
                        "weight": 0.0,
                        "placeMode": "立放&水平旋转"
                    }
                ]
            }
        ]
    }
}

服务状态码

返回码	定义	常见原因
返回码	定义	常见原因
200	返回成功	服务请求正常召回
400	请求失败	请求参数不合法，请按照返回提示修改参数
401	未鉴权	ak不合法或者账号未开通相应权限
403	禁止	未开通白名单，请前往反馈工单联系我们。
503	服务不可用	服务异常，请前往反馈工单联系我们。
500	内部服务错误	服务异常，请前往反馈工单联系我们。

智能配载计算

配载结果展示

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

智能配载查询

API服务地址

服务状态码