Upload API

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

Response

Code Content Description
200 application/json Tileset ingest response 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

Response

Code Content Description
200 application/json Tileset ingest response 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>

Response

Code Content Description
200 application/json Tileset ingest response 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>

Response

Code Content Description
200 application/json Tileset ingest response 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>

Response

Code Content Description
200 application/json Tileset ingest response object

Tileset ingest object

Property Type Description
filename string
size integer
Size in bytes

Example


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

Tileset ingest response 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
size array
Array of Message object
progress number
upload_url string<URL>
URL for the uploaded resource

Example response


{
  "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"
}

Message object

Property Type Description
message string

Example


{
  "message": "string"
}