Home

Awesome

GTFS-Hub

This project aims at providing community tested, probably quality/content enhanced, partially merged or filtered GTFS-feeds of (currently German) transport agencies.

Motivation

Since April, 1st, 2020, DELFI e.V. provides a (75%) Germany wide GTFS feed. However, for some use cases only a regional subset is needed, or locally published feeds need to be merged to retain original trip_ids to match e.g. GTFS-RT feeds.

Additionally, the locally published datasets as well as the Germany-wide DELFI GTFS feed sometimes have quality issues or miss e.g. shape information.

While we hope, that all these problems are overcome soon, we currently still see a need to postprocess published data to overcome these shortcomings.

Inner workings

Updating, checking, enhancing GTFS

GTFS-Hub regularly checks on a list of well known GTFS-feeds for updates.

If they have been updated, they get

Updating and preparing OSM data

Before GFTS data is updated, the OSM data which is used to generate GFTFS shapes is updated. To avoid daily downloading large pbf datasets (GTFS-Hub uses DACH (Germany, Austria, Switzerland) and Alsace (France)) from scratch, we only download the original datasets once and update these afterwards via pyosmium-up-to-date and prepares some region clipped extracts (namely Baden-Wuerttemberg including a buffer of some kilometers around the border).

As this extract will serve as input to OpenTripPlanner as well, we do some additionally data processing on it to enhance some infos, e.g.

Publishing

After updating OSM and GTFS data, you'll find the datasets in the folder data/www, ready to publish e.g. via a web serve serving this directory.

External references

This project uses a couple of other Docker images:

Thanks to everybody contributing to these tools, the OSM community and Geofabrik and the transit agencies providing the data download services.

How to start gtfs-hub

Prerequisites

You'll need to have Docker installed.

Also, make sure you're using the GNU flavor of make. The BSD make (e.g. on macOS) is not fully compatible with this project.

Running GTFS-Hub

All configuration files necessary for the aforementioned processing steps reside in the config directory. The data will be downloaded into and processing within data.

make all

Running GTFS-Hub within a Docker container

GTFS-Hub's Makefile is designed to work both directly on your machine, as well as within a Docker container. This section describes the 2nd setup.

We'll mount the config & data directories into the GTFS-hub container.

Note that, because the Makefile will run the processing tools via docker run, we'll have to enable a Docker-in-Docker setup by

docker run -it --rm \
	-v $PWD/config:/gtfs-hub/config:ro -v $PWD/data:/gtfs-hub/data:rw \
	-v /var/run/docker.sock:/var/run/docker.sock -e HOST_MOUNT=$PWD \
	mfdz/gtfs-hub