模型重建 - 全新司空 2 OpenAPI V1.0

请求参数

Header 参数

X-Request-Id

string <uuid>

请求唯一标识

必需

默认值:

X-Language

enum<string>

可选

枚举值:

zhen

默认值:

zh

X-Project-Uuid

string

项目编号

可选

默认值:

X-User-Token

string

必需

X-User-Token

默认值:

Body 参数application/json

name

string

模型名

必需

reconstruction_type

array[string]

重建类型

必需

枚举值:

model_2dmodel_3d

simplified_factor

number

必需

模型简化系数：建议设置为 0.2，以提高建图效率及建图完成后的浏览体验。

task_folder_id

integer

必需

飞行任务产生的资源文件夹编号，可调用获取飞行任务信息或者获取飞行任务列表接口获取 folder_id作为task_folder_id。

wkt

string

必需

坐标系，请参考《模型重建坐标系》文档

quality_level

enum<string>

重建质量

必需

枚举值:

highmediumlow

reconstruction_mode

enum<string>

必需

建图场景：三维重建时可选择“普通场景”或“环绕场景”。基于几何体或环绕航线进行模型重建时，建议选择环绕场景。

枚举值:

normalsurround

generate_model_formats

array[string]

必需

三维 Mesh或点云模型

枚举值:

b3dmosgbplyobjpntslaspoint_plynormal_point_ply

predefine_area

object

可选

兴趣区域：开启后，用户可在地图界面调整兴趣区域边界，云端将在兴趣区域范围内进行模型重建，提高建模速度。

polygon_points

array [object {2}]

区域点

必需

示例

{
  "name": "creat-model-test",
  "reconstruction_type": [
    "model_3d"
  ],
  "simplified_factor": 0.2,
  "task_folder_id": 3318,
  "wkt": "EPSG:32649",
  "quality_level": "high",
  "reconstruction_mode": "normal",
  "generate_model_formats": [
    "b3dm"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://es-flight-api-cn.djigate.com/openapi/v0.1/model/create' \
--header 'X-Request-Id;' \
--header 'X-Language: zh' \
--header 'X-Project-Uuid: {{X-Project-Uuid}}' \
--header 'X-User-Token;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "creat-model-test",
    "reconstruction_type": [
        "model_3d"
    ],
    "simplified_factor": 0.2,
    "task_folder_id": 3318,
    "wkt": "EPSG:32649",
    "quality_level": "high",
    "reconstruction_mode": "normal",
    "generate_model_formats": [
        "b3dm"
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

非0代表异常

必需

message

string

消息提示

必需

data

object

必需

id

integer

模型 ID

必需

示例

{
  "code": 0,
  "message": "",
  "data": {
    "id": 4437
  }
}