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
- Weather API
- Other
- Description
Authentication
Admin API
On this page