Calculate Best Relay Position for Relay Task

POST

/openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/relay-missions/positions

Call this API before creating a relay task: server queries operating aircraft's dock location + relay aircraft's current location (takes dock location when relay aircraft is in bay; takes aircraft real-time position when airborne) + device RTK calibration status, and computes the "relay point" coordinates and relay operation radius that the relay aircraft will fly to. Then call POST /flight-tasks/relay-missions to create the task. Relay Operation Radius = smaller radius when primary aircraft RTK is calibrated; larger radius when not calibrated (specific values determined by deployment environment configuration).

Call Requirements: Logged-in project member with flight task read-write permission in workspace.

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "main_drone_sn": "1ZNBJ5D0030S2P",
    "secondary_drone_sn": "1ZNBJ5D0030S3Q",
    "mission_position": {
        "latitude": 22.79307789,
        "longitude": 114.35838166,
        "height": 100
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/task/api/v1/workspaces//flight-tasks/relay-missions/positions' \
--header 'x-user-token;' \
--header 'x-user-token;' \
--header 'X-Request-Id: 5dff27bd-693c-4ace-979d-e26e920d497a' \
--header 'X-Request-Id;' \
--header 'X-Project-Uuid;' \
--header 'Content-Type: application/json' \
--data '{
    "main_drone_sn": "1ZNBJ5D0030S2P",
    "secondary_drone_sn": "1ZNBJ5D0030S3Q",
    "mission_position": {
        "latitude": 22.79307789,
        "longitude": 114.35838166,
        "height": 100
    }
}'

Responses

🟢200

application/json

Operation Successful

Bodyapplication/json

Example

{
    "code": 0,
    "message": "success",
    "data": {
        "relay_radius": 50,
        "relay_position": {
            "latitude": 22.79307789,
            "longitude": 114.35838166,
            "height": 48.5
        }
    }
}

🟠400

🔴500

Modified at 2026-06-15 13:36:31

Create Relay Task (Dual-Aircraft Rotation)

Edit Relay Task Configuration