Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

...

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

...

Code Block
ogr2ogr -f "CSV" countries_wkt.csv countries.shp -lco GEOMETRY=AS_WKT -t_srs EPSG:4326

...

MapboxUtils parameters

namemandatoryexampledescription
inputfileyes
--inputfile /workdir/countries_wkt.csv
path of the input CSV file with geometry
geomcolumnyes
--geomcolumn wkt
name of geometry column
tilesetmapidno
--tilesetmapid cleveranalytics.14j1fhp2
Mapbox tilesetmapid. If not specified than random value is generated by Mapbox. Specify in case of updating an existing tileset.
tilesetnameno
--tilesetname countries_wkt-02ssft
Mapbox tilesetname. If not than specified than tilesetname is generated as combination of input file name and random hash. Specify in case of updating an existing tileset or if you need your own tilesetname. 
layernameno
--layername countries_wkt
Mapbox layername. If not specified than same value as tilesetname is used. Specify in case of updating an existing tileset or if you need your own layername. 
minzoomno
--minzoom 5
Minimal zoom of the tileset
maxzoomno
--maxzoom 15
Maximal zoom of the tileset

fields

no
--fields "id:integer;name:string"
Specify fields and their types to be in the tileset
mbtiles_paramsno
--mbtiles_params "drop-fraction-as-needed extend-zooms-if-still-dropping"
Parameters of MBTiles generation internally used by tippecanoe. Parameters can be found here https://github.com/mapbox/tippecanoe
mapboxtokenyes
--mapboxtoken abcdefgah1234
Your Mapbox account token. Token needs to have following priviliges: TILESETS:WRITE, TILESETS:READ, TILESETS:LIST, UPLOADS:READ, UPLOADS:WRITE. Check https://docs.mapbox.com/help/how-mapbox-works/access-tokens/ for more information.

...