Query POI Task Status

GET

/openapi/v2.0/task/api/v1/workspaces/{workspace_id}/flight-tasks/poi-task

Query current POI orbit task status of specified dock/aircraft (center point / radius / speed / payload index). Commonly used by clients to refresh POI panel, or restore UI state after disconnect-reconnect. When target aircraft is not currently in POI orbit (or has never initiated POI task), data field is null.

Request

Path Params

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/task/api/v1/workspaces/e3dea0f5-37f2-4d79-ae58-490af3228069/flight-tasks/poi-task?device_sn=8UUDMAQ00A0152' \
--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;'

Responses

🟢200

application/json

Query Successful; data is null when no current POI task

Bodyapplication/json

Examples

Scenario 1: Query Currently Executing POI TaskScenario 2: No Current POI Task

{
    "code": 0,
    "message": "success",
    "data": {
        "uuid": "5dff27bd-693c-4ace-979d-e26e920d497a",
        "device_sn": "8UUDMAQ00A0152",
        "poi_center_point": {
            "latitude": 22.79307789,
            "longitude": 114.35838166,
            "height": 48.5
        },
        "speed": 5,
        "circle_radius": 20,
        "PayloadIndex": ""
    }
}

🟠400

🔴500

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

Update POI Orbit Speed

Create Relay Task (Dual-Aircraft Rotation)