MapTiler Cloud CLI

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

---

📖 Documentation   🌐 Website   🔑 Get Service token

---

Table of Contents

• Installation
• Basic Usage
• Support
• Contributing
• License
• Acknowledgements

📦 Installation

Requirements

• Python version >= 3.8
• pip
• venv

pip install maptiler-cloud-cli

🚀 Basic Usage

Authorization

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

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

maptiler-cloud --token=MY_TOKEN ...

MAPTILER_TOKEN=MY_TOKEN; maptiler-cloud ...

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.

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

💬 Support

• 📚 Documentation - Comprehensive guides and API reference
• ✉️ Contact us - Get in touch or submit a request
• 🐦 Twitter/X - Follow us for updates

---

🤝 Contributing

We love contributions from the community! Whether it's bug reports, feature requests, or pull requests, all contributions are welcome:

• Fork the repository and create your branch from main
• If you've added code, add tests that cover your changes
• Ensure your code follows our style guidelines
• Give your pull request a clear, descriptive summary
• Open a Pull Request with a comprehensive description

📄 License

This project is licensed under the MIT License – see the LICENSE file for details.

🙏 Acknowledgements

This project is built on the shoulders of giants:

• MapTiler Service API – MapTiler Service API gives you full access to your account including write operations
• Python – A programming language that lets you work quickly and integrate systems more effectively

Get Your API Key ^FREE
Start building with 100,000 free map loads per month ・ No credit card required.

💜 Made with love by the MapTiler team

Website • Documentation • GitHub