Create Annotation Feature Under Specified Layer

POST

/openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-groups/{group_id}/elements

Create an annotation feature under specified layer (point / line / polygon / circle / pin, etc.).

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "example_name",
    "desc": "string_value",
    "source": 1,
    "element_source": 1,
    "resource": {
        "type": 1,
        "remark": "string_value",
        "content": {
            "type": "Point",
            "properties": {
                "color": "#4287f5",
                "clampToGround": true,
                "is3d": true,
                "IsTransparent": true
            },
            "geometry": {
                "type": "Point",
                "coordinates": [
                    {}
                ],
                "radius": 1,
                "breadCrumbs": [
                    {}
                ]
            }
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/map/api/v1/workspaces//element-groups//elements' \
--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 '{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "example_name",
    "desc": "string_value",
    "source": 1,
    "element_source": 1,
    "resource": {
        "type": 1,
        "remark": "string_value",
        "content": {
            "type": "Point",
            "properties": {
                "color": "#4287f5",
                "clampToGround": true,
                "is3d": true,
                "IsTransparent": true
            },
            "geometry": {
                "type": "Point",
                "coordinates": [
                    {}
                ],
                "radius": 1,
                "breadCrumbs": [
                    {}
                ]
            }
        }
    }
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "code": 0,
    "message": "OK",
    "data": {
        "id": "elem-001-uuid"
    }
}

🟠400

🔴500

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

Clear All Annotation Features Under Specified Layer

Batch Import Layers and Annotations (KML-Style JSON)