Wayline Management

Overview

Wayline management is an important function for the autonomous operation of drones, enabling batch and intelligent operations in industry fields. The cloud API provides related interfaces to achieve functions such as sharing, viewing, issuing, canceling, and progress reporting of wayline tasks in the cloud. Users need to follow the Wayline File Format Specification (WPML) to write wayline files, defining the wayline tasks. Multiple waylines can be defined within a single wayline task.

For wayline task interfaces, fields within the interfaces, and explanations of these fields, please refer to the guidance in the "Detailed Interface Implementation" section on this page. If you encounter any errors while using the wayline management feature, please refer to the Error Codes section for a description of the corresponding error based on the returned error code.

Interactive Timing Diagram

Wayline tasks are divided into immediate tasks and scheduled tasks.

Immediate Tasks and Scheduled Tasks

Detailed API Realization

Note:

• If the task_type is specified as "Immediate execution", there is a 30s time error restriction on the device side. If the time difference between when the device receives the command and the execute_time exceeds 30s, an error will be reported, and the task cannot be executed normally.
• If a wayline task is being executed and another execution command for a wayline task is received, the newly received wayline task will not be executed, and an error will be reported on the device.

Wayline Management (MQTT)

• Report Flight Task Progress
  The progress of wayline task execution can be reported, including progress information and extended information.
• Issue Task
  Wayline management now includes a "pre-release" concept, allowing flight tasks to be issued in advance to the airport and aircraft, providing some preparation time. After calling the Issue Task interface, the Execute Task interface must be called to perform the task. task_type specifies the type of task, execute_time is a mandatory field for scheduled and immediate tasks, and is not needed for conditional tasks. ready_conditions is a mandatory field for conditional tasks, with a flighttask_ready event notification when all conditions are met. executable_conditions has no restriction on the