MapTiler Cloud CLI

This tool allows you upload map data into MapTiler Cloud using upload API.

Requirements

• Python version >= 3.8
• pip
• venv

Installation

pip install maptiler-cloud-cli

Authorization

You need an API token to be able to use the tool. The token can be acquired from the Credentials section of your account administration pages in MapTiler Cloud.

Specify it either on the command line or as an environment variable.

maptiler-cloud --token=MY_TOKEN ...

MAPTILER_TOKEN=MY_TOKEN; maptiler-cloud ...

Usage

Create a new tileset

To create a new tileset, use the tiles ingest command.

maptiler-cloud tiles ingest v1.mbtiles

The command will print out the tileset ID on the last line.

ℹ️ The GeoPackage must have a tile matrix set. Read the Vector tiles generating (basic) article to learn how to create a valid GeoPackage or MBTiles from the MapTiler Engine application.

💡 If you reach the tileset limit for your account, you will not be able to upload new tilesets, and you will get an error. Check out our plans to increase the number of tilesets you can have.

Update a tileset

You can use the tileset ID to upload a new file to the same tileset.

maptiler-cloud tiles ingest --document-id=EXISTING_TILESET_ID v2.mbtiles

⚠️ This option replaces the tileset data with the data from the new file. It does NOT add the new data to the existing tileset.

To learn more about using this tool, read How to upload MBTiles or GeoPackage into MapTiler Cloud.

For more control over tileset management, you can use the Admin API. The admin API allows you to create, update or delete a tileset among other actions.