Initiate Real-time Mapping Task (Realtime2D)

POST

/openapi/v2.0/reconstruction/api/v1/workspaces/{workspace_id}/reconstructions

Initiate a real-time mapping (Realtime2D) task (mapping during flight). Server returns OSS upload STS credentials for image source upload + started Job info + resource info. Note: Different from post-processing reconstruction ("Initiate Post-Processing Reconstruction Task (Post 2D / 3D)" API), this API goes through reconstruction svc; used for Realtime2D business layering.

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "sn": "1ZNBH1D00B00GX",
    "name": "example_name",
    "flight_area": {
        "outline": [
            {}
        ]
    },
    "timezone": "string_value"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/reconstruction/api/v1/workspaces//reconstructions' \
--header 'X-Project-Uuid;' \
--header 'X-Request-Id;' \
--header 'X-Request-Id;' \
--header 'x-user-token;' \
--header 'x-user-token;' \
--header 'Content-Type: application/json' \
--data '{
    "sn": "1ZNBH1D00B00GX",
    "name": "example_name",
    "flight_area": {
        "outline": [
            {}
        ]
    },
    "timezone": "string_value"
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "code": 0,
    "message": "OK",
    "data": {
        "upload_info": {
            "accessKeyID": "STS.xxx",
            "accessKeySecret": "yyy",
            "securityToken": "zzz",
            "cloudBucketName": "dji-recon-bucket",
            "cloudObjectKeyPrefix": "recon/workspaces/xxx/",
            "cloudEndpoint": "https://oss-cn-hangzhou.aliyuncs.com",
            "expireTime": 1700100000
        },
        "job_info": {
            "uuid": "job-001-uuid",
            "name": "Real-time Mapping Task-001",
            "status": 1
        },
        "resource_info": {
            "uuid": "resource-001-uuid"
        }
    }
}

🟠400

🔴500

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

Get Real-time Mapping Task List

Get Project Model Library Default Settings