development

ADR › Disturbance API

status	proposed
date	18.04.2023
deciders	Katrin Hartz
consulted	Lining Bao
informed

Kontext und Problemstellung

Ein zentrales Element des Systems ist die Planung und Begleitung von ÖPNV-Reisen. Hierfür muss das System die Strecken, Verbindungen, Abfahrts- und Ankunftszeiten unterschiedlicher Verkehrsmittel abrufen können, um eventuelle Hindernisse während einer Reise feststellen und vermitteln zu können. Dabei müssen geplante Daten, als auch aktuelle Fahrplanänderungen angezeigt und verarbeitet werden. Hierzu ist eine API zum Abfragen der Fahrpläne nötig.

Entscheidungstreiber

Anforderungen
Lizenz und Kosten
Aktualität der Daten
requests/min

In Betracht gezogene Optionen

Ergebnis der Entscheidung

Für das Projekt sollten sowohl DB Timetables als auch Open Data ÖPNV eingebunden werden, da so Pläne und Änderungen der Deutsche Bahn und die Daten der unterschiedlichen Verkehrsunternehmen berücksichtigt werden können. Dadurch haben wir Informationen zu Zügen, Bussen, Bahnen, etc.

Pro und Kontra der Optionen

DB Timetable

Über die Timetables-API können Informationen zur aktuellen Verkehrslage abgefragt werden. Hierbei stehen sowohl Endpunkte zur Verfügung, an denen der aktuell relevante Ausschnitt des Sollfahrplan abgefragt werden kann, als auch Endpunkte an denen die aktuellen Abweichungen zum Sollfahrplan abgefragt werden können. Details dazu finden Sie in der Beschreibung der API.

🟢 Gut, weil kostenfreie Nutzung, Betriebszeit 24/7
🟢 Gut, weil sie geplante Daten zu einer bestimmten Station/Bahnhof liefert
🟢 Gut, weil sie Daten Änderungen zu einer bestimmten Sation liefert (recent changes are updated every 30s)
🟢 Gute Doku
🟡 Neutral, da nur Zug- und Bahnhofsdaten geliefert werden

Open Data ÖPNV

OpenData ÖPNV ist eine Initiative deutscher Mobilitätsunternehmen. Hier finden Sie alle Partnerunternehmen und ihre veröffentlichten Daten, die Sie frei verwenden können. Ob Haltestellen-, Fahrplan- oder Echtzeitdaten. Über die OpenService Schnittstelle können die von den Verkehrsunternehmen gelieferten Echtzeitinformationen abgerufen werden.

🟢 Gut, OpenService Schnittstelle liefert Echtzeitinformationen von verschiedenen Verkehrsunternehmen
🟢 Gut, weil Informationen über weitere Funktionen (Betriebsstörung von Aufzügen/Rolltreppen,…)
🟢 Gut, Testserver (mit original Daten mit zugriff auf Echtzeitdaten, Störungen) der VRR steht zur Verfügung

Ergänzende APIs

Für zusätzliche Informationen bezüglich Haltestellen, Bahnsteig, Gleis, Aufzügen, Parkplätzen,… können folgende APIs der Deutschen Bahn liefern:

DB RIS::Stations -> Informationen und Funktionen rund um Haltestellen, Bahnhöfe, Gleise, Umsteigezeiten
DB Railway-Station Pictures -> Unterstützung bei der Orientierung durch Fotos
DB Sta-Da -> Öffungszeiten, Barrierefreiheit

Diese können als Erweiterung für eine bessere Orientierung und den Umgang mit Herausforderungen genutzt werden.

This site is open source. Improve this page.