Hitchmap

The map to hitchhiking the world.

Report Bug · Request Feature

About The Project

Read more here.

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

Fork and Divergence

This repository, Hitchwiki/hitchmap, is a fork of bobjesvla/hitch. While both projects share a common origin, they have since taken different development paths. At this stage, it remains uncertain which repository will emerge as the mainline project. However, we remain open to collaboration and potential reconciliation of efforts.

For contributors and users, we recommend reviewing both repositories to determine which best fits your needs. In virtually all cases, user-facing contributions will eventually end up in both repositories.

Getting Started

Set up Python virtual environment, install requirements and download the latest database dump:

Works with Python 3.12.6

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

Initialize and run the Flask server:

flask --app hitch init
flask --app hitch generate-all
flask run

In order to run the project continuously, use cron.sh to set up corresponding cronjobs to update the views and hitchmap.conf as a basic NGINX configuration.

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},
}

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.