Page Comparison

This tool is an alternative to Mapbox Studio and lets you easily create or update vector tilesets on Mapbox from your CSV, SHP or GeoJSON files using command line. It can be especially handy if you need to:

• periodically update some vector tileset (e.g. every day updates) using some script
• fine tune zoom levels or other parameters of vector tiles
• overcome Mapbox Studio upload limits

Under the hood the tool is using Mapbox Python API, ogr2ogr and tippecanoe utilites. Just pass your geofile, specify some parameters and you are done. 

Installation

MapboxUtils is distributed as a Docker image so you need to have Docker platform installed. You can get Docker here. 

MapboxUtils is publicly available on Docker hub: https://hub.docker.com/r/clevermaps/mapbox-utils

Use following command to get the image:

docker pull clevermaps/mapbox-utils:latest

Data requirements

• Input file needs to be either in CSV, SHP or GeoJSON format
• Geometry needs to be in WKT format in case of CSV format
• Geometry needs to be in WGS84 coordinate system

MapboxUtils parameters

...

--inputfile /workdir/countries_wkt.csv

...

--tilesetmapid cleveranalytics.14j1fhp2

...

--tilesetname countries_wkt-02ssft

...

--layername countries_wkt

...

--minzoom 5

...

--maxzoom 10

...

--mbtiles_params "drop-fraction-as-needed extend-zooms-if-still-dropping"

...

--mapboxtoken abcdefgah1234

...

...

...

...

...

Running MapboxUtils

Create a new tileset from CSV file

docker run -t -v /home/user/clevermaps/mapbox-utils:/workdir clevermaps/mapbox-utils:latest --inputfile /workdir/countries_wkt.csv --pkeycolumn id --geomcolumn wkt --minzoom 5 --maxzoom 10 --mapboxtoken abcdefgah1234

Create a new tileset from SHP file

docker run -t -v /home/user/clevermaps/mapbox-utils:/workdir clevermaps/mapbox-utils:latest --inputfile /workdir/countries.shp --pkeycolumn id --minzoom 5 --maxzoom 10 --mapboxtoken abcdefgah1234

Update existing tileset