Join us online - 19th of November
Save your spot

Tileset API

MapTiler’s Tileset API allows you to manage your uploaded data via API. You can update the metadata, delete unwanted maps from your account, and much more.

Tileset API reference

Scalar API Reference
v1.0
OpenAPI 3.0.2

MapTiler Service API

Support
Terms of Service
Server:https://service.maptiler.com/v1

MapTiler Service API

Client Libraries
Shell Curl

tileset

​
tileset Operations

List tilesets belonging to your account

​
Query Parameters
  • cursor
    Type: string • base64

    Page cursor

  • limit
    Type: integer
    min:  
    10
    max:  
    100

    Page limit

Responses
  • application/json
Request Example for get/tiles
curl https://service.maptiler.com/v1/tiles

{
  "cursor": "aWQ9ImRlNzY0ZjE0LTRhMzktNGRhMS1iM2QxLTlhYmM5NzQyMzEzYSI=",
  "items": [
    {
      "id": "de764f14-4a39-4da1-b3d1-9abc9742313a",
      "title": "North America",
      "description": "Processed on 04.05.2021",
      "attribution": null
    },
    {
      "id": "b9d06d13-23e6-46ef-a54f-9279965d5761",
      "title": "South America",
      "description": "",
      "attribution": null
    }
  ]
}

Page of tilesets

Get tileset details

​
Path Parameters
  • document_id
    Type: string Format: uuid
    required
Responses
  • application/json
Request Example for get/tiles/{document_id}
curl https://service.maptiler.com/v1/tiles/123e4567-e89b-12d3-a456-426614174000

{
  "id": "de764f14-4a39-4da1-b3d1-9abc9742313a",
  "title": "North America",
  "description": "Processed on 04.05.2021",
  "attribution": null
}

Tileset

Delete tileset

​
Path Parameters
  • document_id
    Type: string Format: uuid
    required
Responses
  • 201

    Resource marked for deletion.

Request Example for delete/tiles/{document_id}
curl https://service.maptiler.com/v1/tiles/123e4567-e89b-12d3-a456-426614174000 \
  --request DELETE
No Body

Resource marked for deletion.

Change tileset metadata

​
Path Parameters
  • document_id
    Type: string Format: uuid
    required
Body·TilesetMetadataChange
application/json
  • attribution
    Type: string
    required
  • description
    Type: string
    required
  • title
    Type: string
    required
Responses
  • application/json
Request Example for post/tiles/{document_id}/change_metadata
curl https://service.maptiler.com/v1/tiles/123e4567-e89b-12d3-a456-426614174000/change_metadata \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "North America",
  "description": "Processed on 04.05.2021",
  "attribution": null
}'

{
  "id": "de764f14-4a39-4da1-b3d1-9abc9742313a",
  "title": "North America",
  "description": "Processed on 04.05.2021",
  "attribution": null
}

Tileset

Using the OpenAPI Specification?
Get the openapi.yaml
Was this helpful?