guidocioni / no-more-wet-rides-new

2 stars 0 forks source link

No more wet rides!

Stuck underneath a tree in a rainy days wondering when is the right time to run home? This app is for you!

Given a start and end point the code finds the best itinerary (using the mapbox api) and computes a best-guess of precipitation intensity according to your arrival time. It then suggests what is the best time to leave in 5 minutes intervals to avoid as much rain as possible.

This app uses the RADOLAN forecast product WN from DWD (https://www.dwd.de/DE/leistungen/radolan/radolan.html).

The RADOLAN data only covers Germany and neighbouring countries.

How does it work?


API endpoint

An endpoint to query the app and obtain a JSON as response is available. Example:

app_url/query?from=Holländische%20Reihe%2015,%20Hamburg&to=Bundesstrasse%2053%20Hamburg

Installation

The script should work fine with both Python2 and Python3. You need the following packages

All the other packages should already be installed in your Python distribution.

The read-in of the RADOLAN files should work out-of-the-box.


Web app

The local web app may be run with

> gunicorn app:server