3D点云检测
功能介绍
用户可使用该api得到点云的检测结果
URI
POST https://{host_url}/v1.0/{project_id}/admodel/point-clouds/3d-detection
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目id |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-FT-SERVICE-ID |
否 |
String |
如果是微调之后的模型，则填在线服务ID |
|
X-FT-SERVICE-ID-WITHOUT-HYPHEN |
否 |
String |
如果是微调之后的模型，则填去掉横线后的在线服务ID |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
pcd |
是 |
String |
点云base64编码，最大10M。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
label_counts |
Array of LabelCount objects |
标注统计信息 |
|
labels |
Array of 3DDetectionLabel objects |
标注信息列表 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
label_meta_attr |
String |
属性 |
|
label_meta_color |
String |
颜色 |
|
label_meta_desc |
String |
描述 |
|
label_meta_id |
Integer |
唯一标识 |
|
label_meta_name |
String |
名称 |
|
label_num |
Integer |
数量 |
|
label_meta_shape |
String |
标签形状 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
label_meta_id |
String |
label类型唯一标识 |
|
name |
String |
标注物名称 |
|
shape_type |
String |
标注物名称 |
|
attribute |
String |
标注物属性 |
|
label_meta_name |
String |
标注物名称 |
|
serial_number |
Integer |
该帧中标注物唯一自增id |
|
cube_3d |
Cube3D object |
检测3D框 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
rotation |
Rotation object |
旋转角 |
|
serial_number |
Integer |
标注物合成对象的唯一自增id，如果标注物之间没有合成则与serial_number保持一致，追踪任务中同一物体在不同帧中此字段相同 |
|
location |
Point3D object |
中心点坐标 |
|
attribute |
String |
属性 |
|
dimensions |
Dimensions object |
长宽高 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_name |
String |
错误名称 |
|
error_msg |
String |
错误信息 |
|
error_suggestion |
String |
错误恢复建议 |
|
error_context |
String |
错误描述 |
|
current_time |
String |
当前时间 |
请求示例
3D点云检测请求体
POST https://{endpoint}/v1.0/{project_id}/admodel/point-clouds/3d-detection
响应示例
状态码：200
OK
{
"label_counts" : [ {
"label_meta_id" : 5414,
"label_num" : 1,
"label_meta_name" : "Car",
"label_meta_desc" : "自采目标识别",
"label_meta_attr" : "{\"优先级\":\"0,1\"}",
"label_meta_shape" : "cube_3d",
"label_meta_color" : "#d0021b"
} ],
"labels" : [ {
"label_meta_id" : 5414,
"name" : "Car",
"shape_type" : "cube_3d",
"attribute" : "",
"label_meta_name" : "Car",
"serial_number" : 0,
"cube_3d" : {
"rotation" : {
"x" : 0,
"y" : 0,
"z" : 1.53980839
},
"serial_number" : 2,
"location" : {
"x" : 0.6671804785728455,
"y" : 15.472203254699707,
"z" : -1.1619998216629028
},
"attribute" : "{\"优先级\":\"1\"}",
"dimensions" : {
"length" : 4.557755470275879,
"width" : 2.0348410606384277,
"height" : 1.4403225183486938
}
}
} ]
}
状态码：400
Bad Request
{
"error_code" : "000003",
"error_name" : "octopus_request_param_error",
"error_msg" : "Request params [usage:TRAINING_TRAINC] is invalid.",
"error_suggestion" : "Please confirm that the request params [usage:TRAINING_TRAINC] is correct.",
"error_context" : "Field error on field: [usage], rejected value: [TRAINING_TRAINC]; Message: Value is not valid.",
"current_time" : "2023-12-13T09:56:21Z"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
|
403 |
权限校验失败 |
|
500 |
系统内部错误 |
错误码
请参见错误码。
