进入任务管理POI模式

POST

/openapi/v0.9/task/api/v1/workspaces/{proj_uuid}/flight-tasks/poi-enter

es-task-service

使无人机进入POI（Point of Interest）模式，围绕指定中心点飞行

请求参数

Path 参数

proj_uuid

string

必需

Header 参数

x-user-token

string

必需

默认值:

X-Request-Id

string

可选

默认值:

{% mock 'uuid' %}

Body 参数application/json

circle_radius

number

可选

圆形半径
required: false

示例值:

device_sn

string

必需

设备SN
required: true

示例值:

SN123456

payload_index

string

可选

负载索引
required: false

示例值:

poi_center_point

object

可选

POI中心点
required: true

height

number

必需

高度
required: true

示例值:

100

latitude

number

必需

纬度
required: true

示例值:

39.9042

longitude

number

必需

经度
required: true

示例值:

116.4074

speed

number

可选

飞行速度
required: false

示例值:

示例

{
    "circle_radius": 10,
    "device_sn": "SN123456",
    "payload_index": 0,
    "poi_center_point": {
        "height": 100,
        "latitude": 39.9042,
        "longitude": 116.4074
    },
    "speed": 5
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/openapi/v0.9/task/api/v1/workspaces//flight-tasks/poi-enter' \
--header 'x-user-token;' \
--header 'X-Request-Id: {% mock '\''uuid'\'' %}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "circle_radius": 10,
    "device_sn": "SN123456",
    "payload_index": 0,
    "poi_center_point": {
        "height": 100,
        "latitude": 39.9042,
        "longitude": 116.4074
    },
    "speed": 5
}'

返回响应

🟢200成功

application/json

成功响应，包含飞行任务ID

Body

HTTP响应模板

code

integer

响应码

可选

message

string

响应消息

可选

data

object

响应数据

可选

flight_id

string

可选

飞行任务ID
example: "1234567890"

fly_to_id

string

可选

飞向目标点任务ID
example: "1234567890"

示例

{
    "code": 0,
    "message": "string",
    "data": {
        "flight_id": "string",
        "fly_to_id": "string"
    }
}

修改于 2025-07-01 03:14:16

智能环绕

退出任务管理POI模式