Map layer¶

Contains map layer object structure and API calls to interact with it.

Map layer object structure:¶

{
    "id": 123456,
    "label": "test"
}

• id - int. Map layer entity ID.
• label - string. Map layer name.

API actions¶

API path: /map_layer.

read¶

Reads the body of the specified layer.

Parameters¶

Examples¶

curl -X POST 'https://api.navixy.com/v2/map_layer/read' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "id": 123456}'

https://api.navixy.com/v2/map_layer/read?hash=a6aa75587e5c59c32d347da438505fc3&id=123456

Response¶

Layer body with content-type: application/vnd.google-earth.kml+xml; charset=utf-8.

Errors¶

• 201 - Not found in the database – if there is no map layer with such ID belonging to current user.

list¶

Returns metadata for all map layers for the user.

Parameters¶

Only API key hash.

Examples¶

curl -X POST 'https://api.navixy.com/v2/map_layer/list' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b"}'

https://api.navixy.com/v2/map_layer/listd?hash=a6aa75587e5c59c32d347da438505fc3

Response¶

{
  "success": true,
  "list": [{
    "id": 123456,
    "label": "test"
  }]
}

Errors¶

No specific errors.

upload¶

Uploads new map layer.

MUST be a POST multipart request (multipart/form-data), with one of the parts being a KML file upload (with the name "file").

Parameters¶

Response¶

{
    "success": true,
    "id": 163
}

• id - int. ID of the created layer.

Errors¶

• 233 - No data file – if file part is missing.
• 234 - Invalid data format – if file has wrong mime type.
• 242 - Validation error – if uploaded file is not valid KML.
• 268 - Over quota – if the user's quota for map layers exceeded.

update¶

Updates metadata for the specified map layer.

Parameters¶

Response¶

{ "success": true }

Errors¶

• 201 - Not found in the database – if there is no map layer with such ID belonging to current user.

delete¶

Deletes specified layer.

Parameters¶

Examples¶

curl -X POST 'https://api.navixy.com/v2/map_layer/delete' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "id": 123456}'

https://api.navixy.com/v2/map_layer/delete?hash=a6aa75587e5c59c32d347da438505fc3&id=123456

Response¶

{ "success": true }

Errors¶

• 201 - Not found in the database – if there is no map layer with such ID belonging to current user.