Create Map Annotation

POST

/openapi/v2.0/map/element

Create map annotation. Supports creating point, line, and polygon annotations.

Request

Header Params

Body Params application/jsonRequired

Example

{
    "name": "dji_tiankongzhicheng",
    "desc": "dji company",
    "resource": {
        "type": 0,
        "content": {
            "type": "Feature",
            "properties": {
                "color": "#2D8CF0",
                "clampToGround": true
            },
            "geometry": {
                "type": "Point",
                "coordinates": [
                    108.42625652534299,
                    30.59263023356542,
                    0
                ]
            }
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/map/element' \
--header 'X-User-Token: {{X-User-Token}}' \
--header 'X-Project-Uuid: 78fec78d-4ef4-488d-90d3-9ff83659598c' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Request-Id: {{$string.uuid}}' \
--header 'X-Language: zh' \
--header 'X-Language: zh' \
--header 'Content-Type: application/json' \
--data '{
    "name": "dji_tiankongzhicheng",
    "desc": "dji company",
    "resource": {
        "type": 0,
        "content": {
            "type": "Feature",
            "properties": {
                "color": "#2D8CF0",
                "clampToGround": true
            },
            "geometry": {
                "type": "Point",
                "coordinates": [
                    108.42625652534299,
                    30.59263023356542,
                    0
                ]
            }
        }
    }
}'

Responses

🟢200

application/json

success

Bodyapplication/json

Example

{
    "code": 0,
    "message": "",
    "data": {
        "id": "5cd3117c-07a5-4ced-ad37-4f67b3cf0060"
    }
}

🟠400

🟠401

🟠403

🟠404

🔴500

Modified at 2026-05-26 14:32:15

Map Tutorial

Annotation Update