Hitchmap

The map to hitchhiking the world. Read more here.

Description

• server.py runs the server
• scripts/show.py builds the main HTML page (index.html). This is where the magic happens.
• scripts/dump.py runs the monthly dump
• cron.sh is the crontab running above files
• hitchmap.conf is the NGINX configuration

License

The software provided in this repository is licensed under AGPL 3.0. The Hitchmap database is licensed under the ODBL, the license used by OpenStreetMap.

Installation (on Linux)

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
curl https://hitchmap.com/dump.sqlite > db/points.sqlite

OR

conda install folium==0.16.0 networkx==3.2.1
curl https://hitchmap.com/dump.sqlite > db/points.sqlite

Getting started

Running

python3 scripts/show.py
python3 server.py

Contributing

Join the conversation about a map for hitchhiking in our Signal Chat.

File an issue if you have a feature request or found a bug.

Perform a pull request from your fork of the repository if you solved an issue. (It's best to file an issue first so we can discuss it and reference it in the PR.)

Data

If you find the data collected and provided by hitchmap.com helpful, feel free to cite it using:

@misc{hitchhiking,
author = {Bob de Ruiter, Till Wenke},
title = {Dataset of Hitchhiking Trips},
year = {2024},
url = {https://hitchmap.com},
}