Batch Import Layers and Annotations (KML-Style JSON)

POST

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

Batch create multiple layer folders and their annotation features in hierarchical structure. Request body is KML-style JSON (not KML XML file).

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "element_groups": [
        {
            "name": "example_name",
            "pid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "p_index": 1,
            "elements": [
                {
                    "type": 1,
                    "name": "example_name",
                    "source": 1,
                    "status": 0,
                    "content": {
                        "type": {},
                        "properties": {},
                        "geometry": {}
                    }
                }
            ]
        }
    ]
}

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 '{
    "element_groups": [
        {
            "name": "example_name",
            "pid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "p_index": 1,
            "elements": [
                {
                    "type": 1,
                    "name": "example_name",
                    "source": 1,
                    "status": 0,
                    "content": {
                        "type": {},
                        "properties": {},
                        "geometry": {}
                    }
                }
            ]
        }
    ]
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "code": 0,
    "message": "OK",
    "data": null
}

🟠400

🔴500

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

Create Annotation Feature Under Specified Layer

Export Features Under Layer Group (KML-Style JSON)