uuqv / 1bahnql

Single unified API for all DBOpenData APIs implemented with GraphQL.

1BahnQL

Single unified API for all DBOpenData APIs implemented with GraphQL. We implemented the following APIs: StaDa, FaSta, TimeTables, Flinkster, CallABike, ParkplätzeAPI, ReiseCenter

GraphiQL Playground

1BahnQL GraphiQL

Usage

Install

The installation requires node.js as the execution environment as well as npm as the package manager. Then run npm install as a command on your commandline interface.

Run

You need an active authentication token to run your personal installation. You can get one on developer.deutschebahn.com. After creating you account you also have to subscribe to desired services by your own.

Use your "Zugangstoken" as the DBDeveloperAuthorization Token and run the server:

DBDeveloperAuthorization=<Your DBOpenData Authentication Token> node index.js

Optional parameters:

• DBBaseURL

ParkAndRide

{ parkandride(start_latitude: 53.55, start_longitude: 9.99, end_latitude: 52.5, end_longitude: 13.4) { routing { parts { delay } from { name location { latitude longitude } hasLocalPublicTransport hasParking } to { name location { latitude longitude } hasLocalPublicTransport hasParking } } } }

Data Sources

Following data sources are currently technically implemented. You need to subscribe to each service at developer.deutschebahn.com to use them with 1BahnQL.

API based sources:

• Stationen (StaDa)
• Fahrstühle (FaSta)
• Fahrplan (Fahrplan-Free)
• Flinkster
• Betriebsstellen
• Reisezentren
• Parkplätze
• Bahnhofsfotos
• https://github.com/derhuerst/db-zugradar-client
• https://github.com/derhuerst/db-hafas
• https://github.com/derhuerst/generate-db-shop-urls
• https://github.com/derhuerst/find-db-station-by-name
• https://github.com/derhuerst/european-transport-modules
• https://github.com/derhuerst/vbb-lines
• https://github.com/derhuerst/db-stations

static sources:

• http://data.deutschebahn.com/dataset/data-bahnsteig
• http://data.deutschebahn.com/dataset/data-bahnsteig-regio
• http://data.deutschebahn.com/dataset/data-wagenreihungsplan-soll-daten
• http://data.deutschebahn.com/dataset/luftschadstoffkataster

Root Queries

Connection Search

tbi

Stringbased Search

• Station
• Zug

Geo Search

• Station
• Bahnsteig
• Flinkster
• Call a Bike
• Parkplätze
• Zug
• Fahrstühle / Rolltreppen

ID Access

• EvaId (Station)
• DS100 (BetrSt)
• Zug
• Flinkster
• Call a Bike
• Fahrstühle / Rolltreppen
• Parkplätze
• Bahnsteig