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

Export Step

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.

Tileserver Step

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

In order to render the oceans you need to import the water polygons from OpenStreetMapData.com. Run the import-water container.

docker-compose up import-water

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

Export the data as MBTiles file to the export directory.

docker-compose up export

Serve the tiles as raster tiles from export directory.

docker-compose up serve