osm2vectortiles

Create Mapbox Streets compatible vector tiles for custom styling with Mapbox Studio Classic and provide easy deployment methods.

Get started

Create a custom OSM base map

TODO: Create documentation for cartographer

Deploy a custom OSM base map

TODO: Create documentation for sysadmin

Components

The project consists of several components.

Import

Import toolchain based on Imposm 3 to import OpenStreetMap data into a PostGIS database. The mapping is optimized for fast generation of vectortiles.

Export

Export toolchain consisting of a custom tm2source project based on the import mapping and tools to scale exporting of the vectortiles horizontally.

Tileserver

A very easy tileserver where you can simply drop in your tm2 style project and our produced mbtiles file and it will serve a custom styled OSM map.

Flow

Development

We use Docker extensively for development and deployment.

Start up your PostGIS container with the data container attached.

docker-compose up -d postgis

Import PBF files from the local import directory. The import container will automatically download a PBF of Zurich for testing.

docker-compose run imposm3

Import SHP files from the local import directory. Or if there is now shapefile available the container will automatically download the water polygons shapefile from OpenStreetMapData.com

docker-compose run importwater

Export the data as MBTiles file to the export directory.

docker-compose run tilelive

Run the tileserver from export directory.

docker-compose up tileserver