Ihr wollt eine Applikation mit ÖPNV-Auskunftskomponente bauen? Im Rahmen unserer OpenData-/OpenService-Strategie stellen wir den aktuellen Fahrplandatenbestand für den AVV-Verbundraum zur Verfügung und bieten die Möglichkeit, über eine ReST-Schnittstelle (API) unmittelbar auf das AVV-Fahrplanauskunftssystem zuzugreifen. Wie es geht, haben wir für euch zusammengestellt.
Fahrplandaten (OpenData)
Für komplexere ÖPNV-Anwendungen sind zugängliche und maschinenlesbare Fahrplandaten erforderlich. Fahrplandaten eignen sich für Dienste auf Solldatenbasis um das generelle Fahrplan-Grundangebot anzuzeigen. Ihr könnt die Daten nutzbringend mit Mehrwert-Diensten kombinieren (z.B. Umgebungssuchen zu Wohnstätten oder Ärzten mit ÖV-Erreichbarkeit).
Für den Austausch von Fahrplandaten hat sich das von Google entwickelte Format GTFS (General Transport Feed Specification) durchgesetzt. Wir stellen Fahrplandatendaten in diesem Format und darüber hinaus im so genannten HAFAS-Rohdatenformat zur Verfügung.
Wenn ihr die Fahrplandaten des AVV für euer Projekt nutzen wollt, dann könnt ihr diese im AVV-OpenData-Portal herunterladen. Weitere Informationen zu den als OpenData bereitgestellten Daten des AVV haben wir in einer Text-Datei zusammengestellt.
Lizenz: Gemäß Beschluss unseres Unternehmensbeirats vom 6.9.2016 sind die Fahrplandaten der AVV-Linien als „gemeinfrei“ lizensiert. Die Fahrwege der Busse sind auf Basis von OpenStreetMap erstellt worden. Daher gilt hierfür „© OpenStreetMap-Mitwirkende“ gemäß der Open Data Commons Open Database Lizenz (ODbL).
Haftungsausschluss: Der bereitgestellte Datenbestand kann Fehler enthalten und/oder unvollständig und/oder nicht aktuell sein. Daher übernehmen wir sowie die AVV-Partnerunternehmen keine Haftung und leisten keinerlei Gewähr. Der AVV behält sich das Recht vor, die Formate, Strukturen und Inhalte der Daten jederzeit zu verändern oder den Service gänzlich einzustellen.
ReST-Schnittstelle (OpenService)
Über eine externe ReST-Schnittstelle (Representational State Transfer) lassen sich viele Funktionen der AVV-Fahrplanauskunft auch in eure Entwicklungen integrieren:
- Abfahrtstafeln,
- Ankunftstafeln,
- Haltestellensuche,
- Verbindungssuche.
Zu allen angebotenen Informationen erhaltet ihr über die Schnittstelle auch die von den Verkehrsunternehmen gelieferten Echtzeitinformationen.
Ihr möchtet für eure Projekte bzw. Entwicklungen auch auf die ReST-Schnittstelle zugreifen? Dann sendet eure Anfrage und eine kurze Projektbeschreibung einfach an api@avv.de.
Nutzungsvereinbarung: Die Freischaltung des Zugriffs auf unseren Auskunftsserver erfolgt erst nach Abschluss einer Nutzungsvereinbarung, in welcher die Bedingungen der Zusammenarbeit zwischen euch als Nutzer der Schnittstelle und dem AVV geregelt sind. Demnach seid ihr im Produktivbetrieb unter anderem verpflichtet,
- einen Hinweis auf den Haftungsausschluss des AVV bzw. der AVV-Partnerverkehrsunternehmen in geeigneter Weise in eure Applikation zu publizieren,
- die Datensicherheitsstandards einzuhalten,
- zu gewährleisten, dass keine Serienabfragen durchgeführt werden können,
- die Daten nur entsprechend des individuell zu vereinbarenden Nutzungszweckes zu verwenden,
- die Daten, insbesondere die Zugangsdaten, nicht an Dritte weiterzugeben.
Nach Prüfung eurer Anfrage bzw. Projektbeschreibung kontaktieren wir euch bezüglich des Abschlusses einer Nutzervereinbarung. Unsere Muster-Nutzungsvereinbarung für die Nutzung unserer ReST-Schnittstelle könnt ihr hier vorab einsehen.
Zugangsdaten: Nach Abschluss der Nutzungsvereinbarung erhaltet ihr von uns individuelle persönliche Zugangsdaten. Mit diesen Zugangsdaten können ihr zunächst unseren Testserver erreichen. Mit dem Testserver könnt ihr eure programmierte App bzw. Anwendung ausgiebig testen. Unser Testserver steht dabei allen Testern zur Verfügung. So kann es vorkommen, dass der Testserver auch mal überlastet ist oder im Rahmen der Wartung temporär nicht verfügbar ist. Zudem kann der Testserver auch unvollständige oder veraltete Daten enthalten. Wenn eure Anwendung stabil läuft und öffentlich Nutzern angeboten werden soll, nutzt bittte unseren Produktivserver. Die Verfügbarkeit dieses Servers entspricht normalem Standard.
Dokumentation: Eine Dokumentation der ReST-Api (Schnittstellenbeschreibung) erhaltet ihr gerne auf Anfrage an api@avv.de. An diese E-Mail-Adresse könnt ihr auch eure Fragen oder Anmerkungen richten.
Wir bitten um Verständnis, dass wir bei Problemen oder Unklarheiten bezüglich der Fahrplandaten und/oder der ReST-Schnittstelle nur in ganz geringem Umfang und ohne Priorität Support leisten können.