osm2vectortiles/README.md

2.5 KiB

osm2vectortiles Build Status

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.

Import Step

Export

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

Export Step

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.

Tileserver Step

Flow

High level flow of the two containers

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