This tool provides the road network as 'routable tiles' that can be consumed by route planning engines such as Planner.js.
It consists of two parts:
- CLI tool to generate routable tiles from an OpenStreetMap extract
- HTTP API to serve the tiles according to the Routable Tiles specification
This is an example for the city of Ghent:
Or the Benelux:
Starting with an extract of OpenStreetMap data (in the .osm.pbf format, for example from Geofabrik downloads), first filter out all non-routing data using Osmosis.
osmosis --read-pbf brussels-latest.osm.pbf --lp --tf accept-ways highway=* route=* --tf accept-relations type=route,restriction --used-node --lp --write-pbf brussels-routing.osm.pbf
On a planet scale, you can do this in three steps if the previous method fails:
- Extract ways:
osmosis --read-pbf planet-latest.osm.pbf --lp --tf accept-ways highway=* route=* --lp --write-pbf planet-1-highways.osm.pbf - Only keep used nodes:
osmosis --read-pbf planet-1-highways.osm.pbf --lp --used-node --lp --write-pbf planet-1-used-nodes.osm.pbf - Only keep routing related relations:
osmosis --read-pbf planet-1-used-nodes.osm.pbf --tf accept-relations type=route,restriction --lp --write-pbf planet-routing.osm.pbf
REMARK: this can probably be optimized by tuning osmosis or using another tool to extract the routing data.
The second step is to convert the prepared OpenStreetMap extract into a tiled database. This 'database' is just a collection of files on disk containing the OSM data per tile.
Using Docker, you can run the CLI as follows, with /path/to/db pointing to an empty directory where you want to store the tiles and /path/to/extract.osm.pbf pointing to the file prepared in the previous step:
docker run --rm -v /path/to/db:/var/app/db/ -v /path/to/extract.osm.pbf:/var/app/source/input.osm.pbf openplannerteam/routeable-tiles
Using Docker, start the container like this, with /path/to/db pointing to the database created in the previous step:
docker run -d -v /path/to/db:/var/app/db/ -v /path/to/logs/:/var/app/logs/ -p 5000:5000 --name routeable-tiles-api openplannerteam/routeable-tiles-api
The tiles should now be available at http://localhost:5000/{z}/{x}/{y}
If you wish to compile the Docker images from the Git repository yourself, run:
git submodule init
git submodule update
dotnet publish -c Release -r linux-x64
docker build -t openplannerteam/routeable-tiles src/RouteableTiles.CLI/
docker build -t openplannerteam/routeable-tiles-api src/RouteableTiles.API/