valhalla-rs (WIP)

Rust wrapper around the Valhalla routing engine.

This aims to replicate the API exposed for the in-tree Python bindings as Rust-familiar typing. For data exchange with the C++ signature we're probably just gonna string-convert back and forth for now.

OSRM Data Setup

git submodule update --init --recursive

# install Valhalla CLIs
cd valhalla
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(nproc) # for macos, use: make -j$(sysctl -n hw.physicalcpu)
sudo make install
cd ../..

# download some data and make tiles out of it
# NOTE: you can feed multiple extracts into pbfgraphbuilder
cd mapdata
wget http://download.geofabrik.de/europe/germany-latest.osm.pbf http://download.geofabrik.de/europe/netherlands-latest.osm.pbf

# get the config and setup
mkdir -p valhalla_tiles
valhalla_build_config --mjolnir-tile-dir ${PWD}/valhalla_tiles --mjolnir-tile-extract ${PWD}/valhalla_tiles.tar --mjolnir-timezone ${PWD}/valhalla_tiles/timezones.sqlite --mjolnir-admin ${PWD}/valhalla_tiles/admins.sqlite > valhalla.json

# build routing tiles
valhalla_build_tiles -c valhalla.json germany-latest.osm.pbf netherlands-latest.osm.pbf

# tar it up for running the server
find valhalla_tiles | sort -n | tar cf valhalla_tiles.tar --no-recursion -T -

Development

Testing

cargo test -vvv -- --nocapture

macOS

brew install automake cmake libtool protobuf-c boost-python libspatialite pkg-config sqlite3 jq curl wget czmq lz4 spatialite-tools unzip luajit bash coreutils binutils
export PATH="/usr/local/opt/binutils/bin:/usr/local/opt/coreutils/libexec/gnubin:$PATH"

git submodule update --init --recursive

cargo build -vv

libgeos linking

If your version of geos is below 3.10.0 you have to remove the line with .cxxflag("-DGEOS_INLINE") in the build.rs file. See valhalla/valhalla#3388 (comment) .

Linux (`.deb` capable distros)

sudo apt install libcurl4-openssl-dev protobuf-compiler libprotobuf-dev \
	libboost-all-dev libsqlite3-dev libspatialite-dev libgeos-dev libgeos++-dev \
	libluajit-5.1-dev libclang-dev clang libkrb5-dev libzmq3-dev

Also, you need to create a symbolic link for the protoc library to avoid the following error: /usr/bin/ld: cannot find -lprotoc

sudo ln -s /usr/lib/x86_64-linux-gnu/libprotoc.so.23.0.4 /usr/lib/x86_64-linux-gnu/libprotoc.so

License

valhalla-rs is licensed under either of

Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

ewilken/valhalla-rs