Upload API

MapTiler Cloud has an Upload API that allows you to add new map tiles or update existing ones from the command line.

To simplify the uploading process, we recommend you use the CLI to run the commands. Follow the guide for installing and using the CLI.

Ingest tileset container into a new tileset

POST https://service.maptiler.com/v1/tiles/ingest

Request

Security: Token Auth

Body

Content-Type Data
application/json

Responses

Code Content Description
200 application/json TilesetIngest Object

Ingest tileset container into existing tileset

POST https://service.maptiler.com/v1/tiles/{document_id}/ingest

Request

Security: Token Auth

Path Parameters

Parameters Type Description
document_id string <uuid>

Body

Content-Type Data
application/json

Responses

Code Content Description
200 application/json TilesetIngest Object

Get tileset ingest details

GET https://service.maptiler.com/v1/tiles/ingest/{ingest_id}

Request

Security: Token Auth

Path Parameters

Parameters Type Description
ingest_id string <uuid>

Responses

Code Content Description
200 application/json TilesetIngest Object

Cancel tileset ingest

POST https://service.maptiler.com/v1/tiles/ingest/{ingest_id}/cancel

Request

Security: Token Auth

Path Parameters

Parameters Type Description
ingest_id string <uuid>

Responses

Code Content Description
200 application/json TilesetIngest Object

Start tileset ingest processing

POST https://service.maptiler.com/v1/tiles/ingest/{ingest_id}/process

Request

Security: Token Auth

Path Parameters

Parameters Type Description
ingest_id string <uuid>

Responses

Code Content Description
200 application/json TilesetIngest Object

TilesetIngestCreate Object

Property Type Description
filename string
size integer
size in bytes

TilesetIngestCreate example


  {
  "filename": "north-america.mbtiles",
  "size": 723000000
}

TilesetIngest Object

Property Type Description
id string <uuid>
document_id string <uuid>
state string
Allowed values: upload processing completed canceled failed
filename string
size number
size in bytes
errors array [Error Object]
progress number
upload_url string <URL>
URL for the uploaded resource

TilesetIngest example


  {
  "id": "e3a507c3-f9dd-4786-8af3-b21f4ca2d9c8",
  "document_id": null,
  "state": "upload",
  "filename": "north-america.mbtiles",
  "size": 723000000,
  "errors": null,
  "progress": 0,
  "upload_url": "https://www.googleapis.com/upload/drive/v3/files/?uploadType=resumable&supportsTeamDrives=true&upload_id=ABg5-UzOoBea-789qB46gXPK7gGIOoTt5rvcGfzdJSxf_iCJ98ysr0WT9asddb-CpBPWFiR_u0DnCWj3oiD9UErtTdVj3w"
}

Error Object

Property Type Description
message string