NEW FlightHub 2 OpenAPI V1.0
  1. Model Management
NEW FlightHub 2 OpenAPI V1.0
  • Root Directory
    • authentication
      • Authentication Tutorial
    • System Service
      • Query FlightHub 2 system status
    • Organize Projects
      • Organize Project Tutorial
      • Get the list of projects under the organization
      • Get the list of devices under the organization
      • Obtain the list of devices under the project
      • Obtain storage upload credentials for the project
      • Add personnel to the project
    • Device Management
      • Device Management Tutorial
      • Device Model Retrieval
      • HMS Information Retrieval
      • Real-time control command distribution
      • Dock camera switch
      • Aircraft Lens Switching
      • Control acquisition
      • Release control
      • Video transmission clarity settings
      • Custom Network RTK Calibration
    • Livestream Management
      • Livestream Management Tutorial
      • Livestream Push
        • Start livestream
      • Bypass Streaming
        • Stream forwarding error code
        • Create Stream Forwarder
        • Enable/Disable stream forwarder
        • Get stream transcoder list
        • Delete stream forwarder
    • Task Management
      • Task Management Tutorial
      • Create Flight Task
      • Updated flight task status
      • Obtain flight task list
      • Obtain media resources generated by the Flight task
      • Obtain Flight task trajectory information
      • Obtain Flight task information
    • Flight Route Management
      • Flight Route Management Tutorial
      • Flight Route Upload Completion Notification
      • Get the list of flight routes under the project
      • Get flight route details
    • Model Management
      • Model Management Tutorial
      • Model reconstruction coordinate system
      • Get the list of models under the project
        GET
      • Get Model Details
        GET
      • Model reconstruction
        POST
    • Annotation Management
      • Annotation Management Tutorial
      • Create map annotation
  1. Model Management

Model reconstruction

Developing
POST
/openapi/v0.1/model/create
Cloud-based post-reconstruction

Request

Header Params
X-Request-Id
string <uuid>
required
Request Unique Identifier
X-Language
enum<string> 
optional
Allowed values:
zhen
Default:
zh
X-Project-Uuid
string 
optional
Project Number
Default:
{{X-Project-Uuid}}
Body Params application/json
name
string 
required
Model Name
reconstruction_type
array[string]
required
Reconstruction Type
Allowed values:
model_2dmodel_3d
simplified_factor
number 
required
Model Simplification Coefficient: It is recommended to set it to 0.2 to improve mapping efficiency and browsing experience after mapping is completed.
task_folder_id
integer 
required
The resource folder number generated by the flight can be obtained by calling the Get Flight Information or Get Flight List interface to acquire the folder_id as task_folder_id.
wkt
string 
required
Coordinate System, please refer to the 'Model Reconstruction Coordinate System' document
quality_level
enum<string> 
required
Reconstruction Quality
Allowed values:
highmediumlow
reconstruction_mode
enum<string> 
required
Mapping scene: During 3D reconstruction, you can choose Normal scene or POI scene. When reconstructing models based on geometry or POI flight routes, it is recommended to choose the POI scene.
Allowed values:
normalsurround
generate_model_formats
array[string]
required
3D Mesh or Point Cloud Model
Allowed values:
b3dmosgbplyobjpntslaspoint_plynormal_point_ply
predefine_area
object 
optional
ROI: Once enabled, users can adjust the ROI boundaries on the map interface, and the cloud will perform model reconstruction within the ROI to improve modeling speed.
polygon_points
array [object {2}] 
required
Polygon point
Example
{
  "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"
  ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/openapi/v0.1/model/create' \
--header 'X-Request-Id;' \
--header 'X-Language: zh' \
--header 'X-Project-Uuid: {{X-Project-Uuid}}' \
--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"
    ]
}'

Responses

🟢200Success
application/json
Body
code
integer 
required
Non-zero indicates an exception
message
string 
required
Message prompt
data
object 
required
id
integer 
required
Model ID
Example
{
  "code": 0,
  "message": "",
  "data": {
    "id": 4437
  }
}
Previous
Get Model Details
Next
Annotation Management Tutorial
Built with