Using Grunt.js to automate export of Tilemill layers
I recently created a choropleth map for The Internet Society where survey data was used to colour interactive maps. The data had several metrics each represented as a switchable layer.
The map tiles were created with Tilemill, an application solely for that purpose.
In Tilemill you configure “Projects” where each project comprises a map, some colour definitions, some data, and several layers of information e.g country boundaries, roads, lakes, bus stops etc.
When you export your finished map it “flattens” those layers into one.
A problem arises when you need to export multiple separate layers as in this example. Tilemill has no means of doing this and every export from the same project is named the same. Even if you renamed the resulting files, once they got uploaded to Mapbox.com they get assigned a random unidentifyable name and their only other identifying meta data is their project name, which are all the same!
The solution using Tilemill is either to create a new Project for each layer (much harder to manage) or for each layer, disable all the others, rename the whole project after that layer and export.
Now chuck in the inevitability that the client corrects the data several times. Each time, all your layers have to be exported. This can get extremely time consuming.
An automated solution
Furthermore each Tilemill project is saved as a JSON file
project.mml. Within it an array contains each of your layers, with an ID, a status and more.
There’s another hurdle too: Tilemill project files must be called
project.mml. You can’t even pass another .mml file as an arg to the CLI.
This is where Grunt comes in. We can automate several processes:
- Create a duplicate of
project.mmlfor every layer to be exported, in which we disable all the other layers we don’t want. Name each duplicate after the layer e.g
- Temporarily backup
project.mmland use the CLI to run an export of layer “foo” only
This is the Grunt task for point 1.
We create a task to achieve points 2. and 3. using grunt-shell
(nb: your path to the Tilmill main file
/Applications/TileMill.app/Contents/Resources/index.js may differ)
The final task is sadly manual. That’s the uploading of each set of tiles to Mapbox.com. However once they’re up there, the changes we made to the project name in each fake .mml file, means the layers will be named identifyably.