更新时间:2024-05-17 GMT+08:00
分享

创建实景三维建模任务

功能介绍

创建实景三维建模任务时,必须绑定工作共享空间。每个工作共享空间内可绑定的任务上限为500个,任务名称需唯一,不能重复(大小写不敏感)。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v1/real3d/{workspace_id}/tasks

表1 路径参数

参数

是否必选

参数类型

描述

workspace_id

String

工作共享空间ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

IAM Token信息,用于租户鉴权,该字段由租户请求IAM的Token接口获得。

表3 请求Body参数

参数

是否必选

参数类型

描述

task_name

String

任务名称。支持中文、英文、数字以及“_”字符,长度限制1~50个字符。

task_description

String

任务描述。支持中文、英文、数字以及“_”字符,长度限制255个字符以内。

task_type

String

任务类型。

  • REAL3D-CTRL:实景三维有控建模

  • REAL3D-UNCTRL:实景三维无控建模

modeling_type

String

建模类型。

  • Mesh:纹理模型实景三维建模。

  • Nerf:显式辐射场实景三维建模。

modeling_params

ModelingParams object

实景三维建模参数。

  • 当请求体中modeling_params为null或者未配置时,其属性均使用缺省值。

  • 当请求体中modeling_params不为null时,则其属性均为必填项,不能省略。

folder_code

String

需要进行三维重建的倾斜影像的影像code。

coordinate_sys

String

建模坐标系。坐标系当前仅支持WGS84-UTM。输入为null或者不填时,均使用缺省值WGS84-UTM。

表4 ModelingParams

参数

是否必选

参数类型

描述

accuracy

String

空三精度。取值包括:Highest、High、Medium、Low、Lowest。

缺省值:High

key_point_limit

Integer

空三关键点数量。取值范围:1000~1000000。

缺省值:40000

tie_point_limit

Integer

空三连接点数量。取值范围:100~100000。

缺省值:4000

mesh_accuracy

Integer

Mesh重建质量。枚举值:

  • 0:高

  • 1:中

  • 2:低

缺省值:0

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

task_id

String

任务ID。

task_name

String

任务名称。

task_type

String

任务类型。

  • REAL3D-UNCTRL(无控建模)

  • REAL3D-CTRL(有控建模)

modeling_type

String

建模类型。

  • Mesh:纹理模型实景三维建模。

  • Nerf:显式辐射场实景三维建模。

task_description

String

任务描述。

workspace_id

String

任务所属工作共享空间ID。

modeling_params

ModelingParams object

任务建模参数列表。

coordinate_sys

String

建模坐标系。

has_marker

Boolean

是否添加了刺点。

folder_code

String

任务绑定的倾斜影像的影像code。

create_time

String

任务创建时间。格式为UTC时间:yyyy-MM-dd'T'HH:mm:ss'Z'。

update_time

String

任务更新时间。格式为UTC时间:yyyy-MM-dd'T'HH:mm:ss'Z'。

tenant_domain_id

String

华为云IAM租户账号ID。

creator

String

任务创建人。

latest_operator

String

任务最近操作人。

task_status

String

任务当前状态。

  • INIT(初始化)

  • PENDING(等待中)

  • STARTING(启动中)

  • START_FAILED(启动失败)

  • RUNNING(运行中)

  • SUCCESS(运行成功)

  • FAILED(运行失败)

  • STOPPING(停止中)

  • STOP_SUCCESS(已停止)

  • ARCHIVED(已归档)

  • BUNDLE_SUCCESS(空三建模成功)

complete_stage

Integer

建模已完成作业步骤数。

total_stage

Integer

建模总作业步骤数。

task_progress

String

任务进度。该字段为字符串表示的保留两位小数的浮点型数值,取值范围:0.00~1.00。

exec_start_time

String

任务执行开始时间。格式为UTC时间:yyyy-MM-dd'T'HH:mm:ss'Z'。

exec_stop_time

String

任务执行结束时间。格式为UTC时间:yyyy-MM-dd'T'HH:mm:ss'Z'。

fail_message

String

失败消息。当任务执行失败时,该字段显示任务的失败原因,用于辅助定位问题。

AT_progress

String

空三建模进度,取值范围:0.00~1.00。展示有控建模任务空三建模阶段的执行进度。因为空三建模仅在有控建模任务中执行,无控建模任务中该字段取值始终为null。

表6 ModelingParams

参数

参数类型

描述

accuracy

String

空三精度。取值包括:Highest、High、Medium、Low、Lowest。

缺省值:High

key_point_limit

Integer

空三关键点数量。取值范围:1000~1000000。

缺省值:40000

tie_point_limit

Integer

空三连接点数量。取值范围:100~100000。

缺省值:4000

mesh_accuracy

Integer

Mesh重建质量。枚举值:

  • 0:高

  • 1:中

  • 2:低

缺省值:0

状态码: 400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。格式为:KMP.XXXXXXXX,其中X表示数字。

最小长度:12

最大长度:12

error_msg

String

错误描述。

最小长度:2

最大长度:512

状态码: 500

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。格式为:KMP.XXXXXXXX,其中X表示数字。

最小长度:12

最大长度:12

error_msg

String

错误描述。

最小长度:2

最大长度:512

请求示例

该请求示例用于创建一个REAL3D-UNCTRL(无控建模)任务。

POST https://{Endpoint}/v1/real3d/c734a30b6c5f42cfaf49e01eb6903xxx/tasks

{
  "task_name" : "测试任务",
  "task_description" : "测试任务",
  "task_type" : "REAL3D-UNCTRL",
  "modeling_type" : "Nerf",
  "folder_code" : "m73MeiI7ztsJpRTaYE3X-YqeZDWfgxxxx",
  "coordinate_sys" : "WGS84-UTM"
}

响应示例

状态码: 200

请求成功。

{
  "task_id" : "914305233ef7428e8073a95d8042xxxx",
  "task_name" : "测试任务1685087027834",
  "task_type" : "REAL3D-UNCTRL",
  "modeling_type" : "Nerf",
  "workspace_id" : "c734a30b6c5f42cfaf49e01eb6903xxx",
  "modeling_params" : {
    "accuracy" : "High",
    "key_point_limit" : "40000",
    "tie_point_limit" : "4000",
    "mesh_accuracy" : "0"
  },
  "coordinate_sys" : "WGS84-UTM",
  "has_marker" : false,
  "folder_code" : "m73MeiI7ztsJpRTaYE3X-YqeZDWfgxxxx",
  "create_time" : "2023-05-26T07:43:47Z",
  "update_time" : "2023-05-26T07:43:47Z",
  "tenant_domain_id" : "xxxx",
  "creator" : "xxxx",
  "latest_operator" : "xxxx",
  "task_status" : "INIT",
  "complete_stage" : null,
  "total_stage" : null,
  "exec_start_time" : null,
  "task_progress" : null,
  "exec_stop_time" : null,
  "fail_message" : null,
  "AT_progress" : null
}

状态码

状态码

描述

200

请求成功。

400

非法请求。

500

服务内部错误。

错误码

请参见错误码

分享:

    相关文档

    相关产品