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 our custom tm2source project based on the import mapping and tools to scale exporting of the vectortiles horizontally.

Serve

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.

Development

We use Docker extensively for development and deployment. The easiest way to get started is using Docker Compose.

Start up your PostGIS container with the data container attached.

docker-compose up -d postgis

Download a PBF and put it into the local import directory.

wget https://s3.amazonaws.com/metro-extracts.mapzen.com/zurich_switzerland.osm.pbf

Now you need to import the PBF files into PostGIS.

docker-compose up import-osm

Now you need to import several external data sources.

Import water polygons from OpenStreetMapData.com.

docker-compose up import-water

Import Natural Earth data for lower zoom levels.

docker-compose up import-natural-earth

Import custom country, sea and state labels.

docker-compose up import-labels

Now import custom SQL functions.

docker-compose up import-sql

Update the scaleranks of OSM places.

docker-compose up update-scaleranks

Export the data as MBTiles file to the export directory.

docker-compose up export-local

Serve the tiles as raster tiles from export directory.

docker-compose up serve

Docker Images

The workflow consists of several prebuilt Docker images.

Image	Size
osm2vectortiles/serve
osm2vectortiles/export
osm2vectortiles/import-external
osm2vectortiles/import-sql
osm2vectortiles/import-osm
osm2vectortiles/update-scaleranks
osm2vectortiles/postgis
osm2vectortiles/pgbouncer