更新时间:2025-05-26 GMT+08:00
分享

3D点云分割

功能介绍

用户可使用该api得到点云的分割结果

URI

POST https://{host_url}/v1.0/{project_id}/admodel/point-cloud-data/3d-segmentation

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目id

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

pcd

String

点云base64编码,最大10M。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

label_counts

Array of LabelCount objects

标注统计信息

labels

Array of 3DSegmentationLabel objects

标注信息列表

labels_ext

labels_ext object

标注扩展信息

表4 LabelCount

参数

参数类型

描述

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

标签形状

表5 3DSegmentationLabel

参数

参数类型

描述

label_meta_id

String

label类型唯一标识

polygon_3d_v2

polygon_3d_v2 object

3d标注

name

String

标注物名称

attribute

String

标注物属性

shape_type

String

标注物名称

label_meta_name

String

标注物名称

表6 polygon_3d_v2

参数

参数类型

描述

ascii_char

String

该类标注物使用的符号

表7 labels_ext

参数

参数类型

描述

ascii_string

String

该帧点云每个点的类别,和labels中polygon_3d_v2->ascii_char对应

状态码:400

表8 响应Body参数

参数

参数类型

描述

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-cloud-data/3d-segmentation

响应示例

状态码:200

OK

{
  "label_counts" : [ {
    "label_meta_id" : 1853,
    "label_num" : 1,
    "label_meta_name" : "truck",
    "label_meta_desc" : "v0504",
    "label_meta_attr" : "{\"优先级\":\"0,1\"}",
    "label_meta_shape" : "polygon_3d_v2",
    "label_meta_color" : "#f8e71c"
  }, {
    "label_meta_id" : 1854,
    "label_num" : 1,
    "label_meta_name" : "car",
    "label_meta_desc" : "car0504",
    "label_meta_attr" : "{\"优先级\":\"0,1\"}",
    "label_meta_shape" : "polygon_3d_v2",
    "label_meta_color" : "#7ed321"
  } ],
  "labels" : [ {
    "label_meta_id" : 1854,
    "polygon_3d_v2" : {
      "ascii_char" : "$"
    },
    "name" : "car",
    "shape_type" : "polygon_3d_v2",
    "attribute" : "",
    "label_meta_name" : "car"
  }, {
    "label_meta_id" : 1853,
    "polygon_3d_v2" : {
      "ascii_char" : "#"
    },
    "name" : "truck",
    "shape_type" : "polygon_3d_v2",
    "attribute" : "",
    "label_meta_name" : "truck"
  } ],
  "labels_ext" : {
    "ascii_string" : "   $$$$$          #####"
  }
}

状态码: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

系统内部错误

错误码

请参见错误码

相关文档