Für die Nutzung von Echtzeit-Fahrplandaten aus dem landesweiten Fahrplanauskunftssystem (EFA-BW) bestehen mehrere Optionen.
Neben der TRIAS-API stellen wir seit Kurzem auch die EFA-JSON-API als Alternative offen bereit. Darüber hinaus können Sie mit dem Abfahrts- bzw. Ankunftsmonitor einen fertigen HTML-Monitor nutzen, der ebenfalls Soll- und Echtzeit-Fahrplandaten aus der EFA-BW bezieht und sie in Tabellenform aufbereitet. Je nach Anwendungsfall können Sie mit Ihrer Anwendung Live-Daten und/oder fertige Fahrtempfehlungen abrufen, ohne sich Gedanken über Verkehrsbeschränkungen, Umsteigezeiten oder das Routing zu machen.
Die TRIAS- und EFA-JSON-API ermöglichen Abfragen zu einzelnen Verbindungen, als auch Abfahrten einzelner Haltepunkte. Es handelt sich hierbei nicht um einen flächendeckenden, gebündelten GTFS-Realtime-Stream. Anzumerken ist, dass im zeitlichen Nahbereich auch Prognose- und Echtzeitinformationen einzelner Fahrten enthalten sind, sofern diese der NVBW vorliegen. Verantwortlich für die Datengrundlage sind hierbei die Verkehrsverbünde, sowie die jeweiligen Verkehrsunternehmen.
Nutzen Sie die Schnittstellen, um ein neues Informationsangebot zu entwickeln. Die Daten werden in der gleichen Qualität angeboten, in der sie die Verkehrsunternehmen zur Fahrgastinformation einsetzen.
Support
MobiData BW® übernimmt für die TRIAS-Schnittstelle den First-Level-Support. Das heißt, dass wir Anfragen technischer oder inhaltlicher Natur mit direktem TRIAS-Bezug aufnehmen und bearbeiten. Für die EFA-JSON-API bieten wir einen solchen Support nicht an.
Gerne unterstützt das Team hinter MobiData BW® datenbasierte Projektideen bei ihrem Innovationsprozess, bei der Verbindung möglicher Kooperationspartner, ihrer inhaltlichen Ausgestaltung, und den damit verbundenen grundlegenden technischen Fragestellungen. Eine engmaschige Unterstützung bei der programmiertechnischen Umsetzung von Anwendungen ist nicht angedacht. Vor technischen Anfragen zur TRIAS-Schnittstelle möchten wir Sie außerdem darum bitten, die sehr ausführlichen Dokumentationen und Hilfsmittel auf dieser Seite zur Kenntnis zu nehmen.
TRIAS-API
TRIAS steht für Travel Information and Advisory Standard. Die Schnittstelle basiert auf dem XML-Format und verwendet das POST-Protokoll. Die aktuelle Version der Schnittstelle ist 1.2.
Wie der Name schon andeutet, fußt diese herstellerneutrale Schnittstelle auf dem internationalen TRIAS-Standard. Der Standard ermöglicht eine interoperable und einheitliche Datenstruktur für eine reibungslose Integration zwischen verschiedenen Anbietern und Regionen. Damit eignet sich die TRIAS besonders für Anwendungen, die eine Standardkonformität und Zusammenarbeit über Regionen hinweg erfordern. Das Format der Schnittstelle ist vom Verband Deutscher Verkehrsunternehmen (VDV) in der VDV Schrift Nr. 431-2 dokumentiert.
Mittels der TRIAS-Schnittstelle können Sie die historischen Sollfahrplandaten für einen Zeitraum der vergangenen sieben Tage abrufen. Echtzeitdaten der einzelnen Fahrten sind hingegen für wenige Stunden in die Vergangenheit nachvollziehbar.
Detailliertere Informationen zur Schnittstelle und unterstützten Abfragen finden Sie im Factsheet TRIAS.
Zugang
Bei Interesse an einem Zugriff auf die TRIAS-API nehmen Sie gerne Kontakt zu uns auf unter folgender E-Mail-Adresse: mobidata-bw@nvbw.de
Für die Nutzung der APIs gelten folgende Bestimmungen, diese können Sie vorab zur Kenntnis nehmen:
Bitte geben Sie dabei folgende Informationen an:
* Vor- und Nachname;
* Name der Institution (bei Privatpersonen reicht der vollständige Name);
* Anschrift;
* E-Mail Adresse, die wir als Kontakt hinterlegen sollen;
* Falls möglich, eine kurze Projekt- und Innovationsbeschreibung, damit mögliche Synergien identifiziert werden können.
Mit Ihrer Kontaktaufnahme akzeptieren Sie die Nutzungsbedingungen. Bei der Übermittlung Ihrer Daten gilt die Datenschutzerklärung von MobiData BW®.
Nach einer Prüfung Ihrer Anfrage erhalten Sie einen kundenspezifischen Zugang zu den Datensätzen mit eigenem Endpunkt der TRIAS-API und individualisierter Authentifizierung.
EFA-JSON-API
Die EFA-JSON-API basiert auf dem JSON-Format und verwendet das GET-Protokoll. Die aktuelle Version der Schnittstelle ist 10.6.14.22.
Sie verfügt sie über keine strikte Standardisierung der Antwortstrukturen, was regionale Unterschiede ermöglicht. Der Fokus liegt auf einer einfachen Nutzung mit vorgefertigten Funktionen wie Haltestellensuche, Verbindungen und Abfahrtsmonitor. Die Integration in lokale Anwendungen und Projekte ist daher vergleichsweise unkompliziert.
Ein Beispiel-Request könnte so aussehen:
Abgefragt wird hier die Haltestelle Stuttgart Hauptbahnhof (oben) mit der Info, dass der Haltestellentyp beliebig sein kann. Anders als bei TRIAS werden die Abfrageparameter in der URL aufgenommen und nicht im Body bei gleichbleibender URL bestimmt.
Für die Nutzung der EFA-JSON-API gelten die Nutzungsbedingungen TRIAS, diese können Sie vorab zur Kenntnis nehmen.
Zugang
Für die Nutzung der EFA-JSON-API müssen Sie keinen Zugang beantragen.
Abfahrts-/Ankunftsmonitor
Wenn Sie einen Abfahrts- oder Ankunftsmonitor bauen wollen, möchten wir Sie außerdem auf den MobiData BW® Abfahrts- und Ankunftsmonitor hinweisen. Hierzu gibt es eine ausführliche Anleitung einschließlich Abfrage-URL-Generator und eine Dokumentation von Best-Practice-Beispielen.
