Layers API

Create, manage, and serve composite map layers.

List Layers

GET /v1/layers

Returns all layers in your account.

Create Layer

POST /v1/layers

Request Body

Field	Type	Required	Description
name	string	Yes	Layer name
sources	string[]	Yes	Data sources: aerial, cadastral, custom
bounds	object	Yes	Geographic bounds
style	object	No	Layer styling options

Example

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Brisbane CBD Overview",
    "sources": ["aerial", "cadastral"],
    "bounds": {"north": -27.46, "south": -27.48, "east": 153.04, "west": 153.02},
    "style": {
      "cadastral": {
        "stroke": "#b3b637",
        "strokeWidth": 2,
        "fill": "rgba(179,182,55,0.1)"
      }
    }
  }' \
  https://api.geolocarta.com/v1/layers

Response

{
  "data": {
    "id": "lyr_abc123",
    "name": "Brisbane CBD Overview",
    "tile_url": "https://tiles.geolocarta.com/layers/lyr_abc123/{z}/{x}/{y}.png",
    "created_at": "2026-03-15T10:00:00Z"
  }
}

Get Layer

GET /v1/layers/{id}

Update Layer

PATCH /v1/layers/{id}

Delete Layer

DELETE /v1/layers/{id}