GTFS API server

This repo contains the Open Data Hub GTFS API

It's goal is to provide a single access point where Open Data Hub users can discover and download GTFS files and some metadata related to them

The API is a simple storage-less frontend to GTFS files hosted somewhere else (primarily on a S3 bucket)

Initial API proposal can be found here

Usage

A calls.http file with example calls is provided. To use it, you have to install the VSCode extension REST Client or something compatible

List available datasets

GET /v1/dataset -> application/json  

Returns a map of available GTFS datasets by ID

{
    "<dataset id>": {
        "description": String,
        "endpoint": String(URL),
        "origin": String
        "license": String
        "metadata": JSON
    },
...

dataset id the unique identifier of the dataset used in other calls
description A short description of the dataset
endpoint URL that points to the raw GTFS zip file download
origin Name of the data provider
license SPDX license identifier under which the data is provided
medadata A free form JSON that may provide additional information

For the most part, these are defined verbatim in the datasets.yml file

Get metadata information of a specific dataset

GET /v1/dataset/<dataset id> -> application/json  

The same as this call but restricted to a specific dataset

Download the GTFS file of a dataset

GET /v1/dataset/<dataset id>/raw -> application/zip

Returns the raw GTFS file with filename = <dataset id>.zip

Development

Installation

docker-compose up to start your local development environment

if you don't want to use docker, try npm install npm run dev

Dataset configuration

Datasets are configured in datasets.yml

Source

Currently supported source types:

• http/s
• FTP

Caching

GTFS files are cached in memory. The time to live before cache expires is configured per-dataset via the cache_ttl parameter

REUSE

This project is REUSE compliant, more information about the usage of REUSE in NOI Techpark repositories can be found here.

Since the CI for this project checks for REUSE compliance you might find it useful to use a pre-commit hook checking for REUSE compliance locally. The pre-commit-config file in the repository root is already configured to check for REUSE compliance with help of the pre-commit tool.

Install the tool by running:

pip install pre-commit

Then install the pre-commit hook via the config file by running:

pre-commit install