OpenMapTiles automatic updates

Published Apr 04, 2019

To save your time, disk storage and internet connection, we prepared the automated update system. A single script brings you regular weekly updates of OpenStreetMap vector tiles.

1/3 of the size for a single update

Previously, making an update meant downloading the whole 60 GB file. With the automatic updates script, you have to download just the difference, where the size is about 20 GB, which is only one-third of the size. 

After download, the script, which is a collection of console-based commands in a single binary file, merges differences and creates a new planet MBTiles file. When the update script finishes, just restart your service and your maps are updated.

Your map services are available through the whole update process without any interruption, except for a short timeout during the restart of your web server.

One update process takes approx 1 hour (download, merge and verify) on a fast local SSD.

Automatic Updates on all major platforms

The automated update system is available on Windows, Mac and Linux for customers with an active subscription to the Business Production Package. Visit the automatic update page, download the script for your OS and get your credentials:

Then run the script:

autoupdate /path/to/planet.mbtiles --email
name.surname@emailprovider.com --token XXXXXXX

This script will look up for a fresher version of your map in loops until it has the latest planet. It means if you made your download four weeks ago and no updates afterward, it would last four times longer to get the latest planet.

To have always the freshest map, set up this script to run as a service each week on Wednesday noon when we usually release the new planet.

You can also subscribe with your email to receive notifications when the new planet is available and set up a custom trigger to start the update process when you receive the email.

Martin Mikita

Software engineer
Published on Apr 04, 2019

Share