Skip to content
Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time

Jupyter examples to use openrouteservice


(Mostly) real-world examples and inspirations to use the full range of ORS services and clients.

For an instant setup, you can use MyBinder to start an interactive Jupyter server.

Local installation

# clone the repo and enter folder
git clone
cd openrouteservice-examples

# Install the requirements in a virtual env and activate it
python -m venv .venv
source .venv/bin/activate

pip install -r requirements

Note: In case jupyter is already installed globally, and you want to use the local version, you can create a symlink to the local jupyter with:

ln -s .venv/bin/jupyter jupyter

Then, run jupyter commands with ./jupyter instead.

Launch the Jupyter server on the python directory

jupyter notebook python/


If you are not just using but editing or adding notebooks, you need to install the jupytext extension

# set up jupytext server extension
jupyter nbextension install --py jupytext --user
jupyter nbextension enable jupytext --user --py
jupyter serverextension enable jupytext

Note, that every notebook is paired with a corresponding .py-file of the same name. On changing either the notebook or the .py-file, the other one will be automatically updated.

When reviewing changes, only the .py-file needs to be looked at, the .ipynb-file is only kept for use with jupyter in the browser and to render maps and other information.

Pairing new notebooks

New notebooks have to be paired by clicking File > Jupytext > Pair notebook with light Script


📚 (Mostly) real-world examples and inspirations to use the full breadth of ORS services and clients




No releases published


No packages published