https://github.com/giscience/openrouteservice-examples
:books: (Mostly) real-world examples and inspirations to use the full breadth of ORS services and clients
https://github.com/giscience/openrouteservice-examples
Last synced: 11 months ago
JSON representation
:books: (Mostly) real-world examples and inspirations to use the full breadth of ORS services and clients
- Host: GitHub
- URL: https://github.com/giscience/openrouteservice-examples
- Owner: GIScience
- License: apache-2.0
- Created: 2018-03-26T20:36:57.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2024-12-19T08:02:01.000Z (about 1 year ago)
- Last Synced: 2025-03-29T03:08:15.343Z (12 months ago)
- Language: Jupyter Notebook
- Homepage: https://openrouteservice.org
- Size: 95.1 MB
- Stars: 94
- Watchers: 17
- Forks: 46
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Jupyter examples to use openrouteservice
[](https://mybinder.org/v2/gh/GIScience/openrouteservice-examples/master?filepath=python)
(Mostly) real-world examples and inspirations to use the full range of ORS services and clients.
For an instant setup, you can use [MyBinder](https://mybinder.org/v2/gh/GIScience/openrouteservice-examples/master?filepath=python)
to start an interactive Jupyter server.
### Local installation
```bash
# clone the repo and enter folder
git clone https://github.com/GIScience/openrouteservice-examples.git
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.txt
```
> 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/
### Development
If you are not just using but editing or adding notebooks, you need to install the jupytext extension
```bash
# set up jupytext server extension, needs Jupyter Notebook 7 or later
jupyter labextension enable jupyterlab-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 Format`