VersaTiles Converter

The converter is a command in the versatiles tool (Install).

It can convert tileset between versatiles, mbtiles and pmtiles containers, tar archives and directories.

Usage

versatiles convert [options] <src> <dest>

Examples

Convert an mbtiles container to versatiles:

versatiles convert input.mbtiles dest.versatiles

Convert an directory containing tiles in dir/z/x/y.ext format to pmtiles:

versatiles convert dir dest.pmtiles

Key Options

Option	Description
--bbox <W,S,E,N>	Crop tiles to this geographic bounding box (decimal degrees)
--bbox-border <tiles>	Expand the bounding box by this many extra tiles on each side
--min-zoom <z>	Discard tiles below this zoom level
--max-zoom <z>	Discard tiles above this zoom level
--format <fmt>	Re-encode tile data — e.g. png, jpg, webp, pbf

Run versatiles convert --help for the full option listing.

Convert GeoJSON to VersaTiles container

VersaTiles convert is not yet able to convert GeoJSON or other GIS formats to tilesets. In the meantime we recommend using tippecanoe to generate an mbtiles container and then convert said container to the versatiles container format.

tippecanoe -o tmp.mbtiles src.geojson
versatiles convert tmp.mbtiles dest.versatiles
rm tmp.mbtiles