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
You must include an Service Token with every API request
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
You must include an Service Token with every API request
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
You must include an Service Token with every API request
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
You must include an Service Token with every API request
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
You must include an Service Token with every API request
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
|
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
|
Error Object
| Property | Type | Description |
|---|---|---|
| message | string |
APIs
- Maps API
- Static Maps API
- Tiles API
- Data API
- Geocoding API
- Geolocation API
- Coordinates API
- Other
- Description
Authentication
Admin API
On this page