快照上传回调

POST

/openapi/v0.9/wayline/api/v1/workspaces/{proj_uuid}/waylines/{id}/snapshot-callback

es-file-storage

处理快照上传后的回调

请求参数

Path 参数

proj_uuid

string

必需

string

航线ID

必需

示例值:

123

Header 参数

x-user-token

string

必需

默认值:

X-Request-Id

string

可选

默认值:

{% mock 'uuid' %}

Body 参数application/json

projectID

string

必需

项目ID
example: 4dbc6ef2-0e3c-4d47-8b32-552a44f573c5

snapshot_list

array [object {13}]

快照列表

必需

<= 100 items

action_uuid

string

必需

动作UUID
example: 4dbc6ef2-0e3c-4d47-8b32-552a44f573c5

flight_yaw

number

可选

飞行偏航角
example: 0.0

focal_length_in_35_mm

number

可选

35mm等效焦距
example: 24.0

gimbal_pitch

number

可选

云台俯仰角
example: 0.0

gimbal_yaw

number

可选

云台偏航角
example: 0.0

height

integer

可选

高度
example: 1080

name

string

可选

文件名称
example: snapshot.jpg

object_key

string

必需

对象键
example: snapshot/123.jpg

photo_position

object

照片位置

可选

shoot_position

object

拍摄位置

可选

uuid

string

必需

快照UUID
example: 4dbc6ef2-0e3c-4d47-8b32-552a44f573c5

width

integer

可选

宽度
example: 1920

zoom_factor

number

可选

缩放因子
example: 1.0

waylineUUID

string

必需

航线UUID
example: 4dbc6ef2-0e3c-4d47-8b32-552a44f573c5

示例

{
    "projectID": "9809b927-c24c-4371-b006-5b326af09492",
    "snapshot_list": [
        {
            "action_uuid": "2729fe9b-6760-451b-a973-9cdbf8ddbf20",
            "flight_yaw": 0,
            "focal_length_in_35_mm": 120,
            "gimbal_pitch": 0,
            "gimbal_yaw": 0,
            "height": 300,
            "name": "bb733b73-ccf5-4dfb-9b18-d055d3d865af",
            "object_key": "bb733b73-ccf5-4dfb-9b18-d055d3d865af/snapshot-f8fb5681-0df6-4b88-b3f3-8e88f2183c8f.webp",
            "photo_position": {
                "abs_alt": 0,
                "lat": 0,
                "lng": 0,
                "rel_alt": -41.564450329
            },
            "shoot_position": {
                "abs_alt": 132,
                "lat": 11,
                "lng": 11,
                "rel_alt": 134
            },
            "uuid": "8fe9bc40-fc15-43c7-a960-6c928541d86e",
            "width": 400,
            "zoom_factor": 5
        }
    ],
    "waylineUUID": "b2f58095-01b6-4611-b74e-6acc5d7b0218"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/openapi/v0.9/wayline/api/v1/workspaces//waylines/123/snapshot-callback' \
--header 'x-user-token;' \
--header 'X-Request-Id: {% mock '\''uuid'\'' %}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "projectID": "9809b927-c24c-4371-b006-5b326af09492",
    "snapshot_list": [
        {
            "action_uuid": "2729fe9b-6760-451b-a973-9cdbf8ddbf20",
            "flight_yaw": 0,
            "focal_length_in_35_mm": 120,
            "gimbal_pitch": 0,
            "gimbal_yaw": 0,
            "height": 300,
            "name": "bb733b73-ccf5-4dfb-9b18-d055d3d865af",
            "object_key": "bb733b73-ccf5-4dfb-9b18-d055d3d865af/snapshot-f8fb5681-0df6-4b88-b3f3-8e88f2183c8f.webp",
            "photo_position": {
                "abs_alt": 0,
                "lat": 0,
                "lng": 0,
                "rel_alt": -41.564450329
            },
            "shoot_position": {
                "abs_alt": 132,
                "lat": 11,
                "lng": 11,
                "rel_alt": 134
            },
            "uuid": "8fe9bc40-fc15-43c7-a960-6c928541d86e",
            "width": 400,
            "zoom_factor": 5
        }
    ],
    "waylineUUID": "b2f58095-01b6-4611-b74e-6acc5d7b0218"
}'

返回响应

🟢200成功

application/json

成功响应

Body

code

integer

响应码

可选

message

string

响应消息

可选

data

object

可选

list

array[object (wayline_vo.SnapshotOutputItem) {2}]

快照列表

可选

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "list": [
            {
                "create_at": 1750219862604,
                "uuid": "c9290a40-6c61-42de-86ce-2def90178b51"
            },
            {
                "create_at": 1750219862604,
                "uuid": "944514fb-c5f9-4af2-8c37-407d115db6c6"
            }
        ]
    }
}

修改于 2025-06-26 09:55:59

获取高程文件列表

裁剪精准复拍航线媒体文件