Dienste

Transportdienste

Der Adapter unterstützt drei verschiedene Transportdienste (Backends), die über das Profil-Dropdown in der Konfiguration ausgewählt werden. Alle drei Dienste implementieren dieselbe interne Schnittstelle und liefern die gleichen Datenpunkte.

---

Übersicht

Dienst	Profil-Auswahl	npm-Paket	Region
HAFAS – VBB	hafas:vbb	hafas-client	Berlin/Brandenburg
HAFAS – ÖBB	hafas:oebb	hafas-client	Österreich
HAFAS – VBN	hafas:vbn	hafas-client	Bremen/Niedersachsen
HAFAS – RMV	hafas:rmv	hafas-client	Rhein-Main/Mainz
HAFAS – VMT	hafas:vmt	hafas-client	Thüringen
Deutsche Bahn (Vendo) — derzeit deaktiviert	vendo:db	db-vendo-client	Deutschland
MOTIS/Transitous	motis:compat	@motis-project/motis-fptf-client	DE & Europa

---

HAFAS (hafas:vbb, hafas:oebb, hafas:vbn, hafas:rmv, hafas:vmt)

HAFAS ist das weit verbreitete Fahrplanauskunftssystem vieler europäischer Verkehrsverbünde. Der Adapter nutzt das Open-Source-Paket hafas-client, das HAFAS-Profile für zahlreiche Betreiber bereitstellt.

Der Adapter enthält fünf vorkonfigurierte Profile:

VBB – Verkehrsverbund Berlin-Brandenburg (hafas:vbb)

Deckt den öffentlichen Nahverkehr in Berlin und Brandenburg ab (S-Bahn, U-Bahn, Straßenbahn, Bus, Fähre, Regionalbahn/express).

Verfügbare Verkehrsmittel: suburban, subway, tram, bus, ferry, express, regional

ÖBB – Österreichische Bundesbahnen (hafas:oebb)

Deckt den öffentlichen Verkehr in Österreich ab (ICE/Railjet, IC/EC, Interregio, Regionalzüge, S-Bahn, Bus, Fähre, U-Bahn, Straßenbahn, Rufbus).

Verfügbare Verkehrsmittel: nationalExpress, national, interregional, regional, suburban, bus, ferry, subway, tram, onCall

VBN – Verkehrsverbund Bremen/Niedersachsen (hafas:vbn)

Deckt den öffentlichen Nahverkehr in Bremen und Niedersachsen ab.

Verfügbare Verkehrsmittel: expressTrain, nationalTrain, localTrain, suburban, bus, watercraft, subway, tram, dialARide

RMV – Rhein-Main-Verkehrsverbund (hafas:rmv)

Deckt den öffentlichen Verkehr im Rhein-Main-Gebiet (Frankfurt, Wiesbaden, Mainz, Hessen) ab.

Verfügbare Verkehrsmittel: expressTrain, longDistanceTrain, regionaTrain, sBahn, uBahn, tram, bus, watercraft, ast, cableCar

Hinweis: RMV verwendet eigene Produkt-IDs (s-bahn, u-bahn, long-distance-train, regiona-train, cable-car) statt der von VBB/ÖBB bekannten. Der Adapter bildet sie auf die camelCase-Schlüssel oben ab — regionaTrain ist dabei kein Tippfehler, sondern entspricht der HAFAS-Produkt-ID regiona-train.

VMT – Verkehrsverbund Mittelthüringen (hafas:vmt)

Deckt den öffentlichen Verkehr in Thüringen ab.

Verfügbare Verkehrsmittel: longDistanceTrain, regionalTrain, tram, bus

Throttling

Alle HAFAS-Clients werden mit aktiviertem Throttling (withThrottling) initialisiert, um die Rate der API-Anfragen zu begrenzen und eine Sperrung durch den Dienst zu vermeiden.

Client-Name

Der Client-Name wird im HTTP-User-Agent der API-Anfragen verwendet. Er setzt sich zusammen aus:

{clientName}-{zufällige Zahl 0–1000}

Der clientName kann optional in den Einstellungen konfiguriert werden. Standard: iobroker-public-transport.

---

Deutsche Bahn – Vendo (vendo:db) — derzeit deaktiviert

Dieses Profil ist seit Adapter-Version 0.10.0 deaktiviert und im Profil-Dropdown nicht auswählbar. Der db-vendo-Endpoint der Deutschen Bahn beantwortet die Anfragen des Adapters mit OPS_BLOCKED (serverseitige Sperre), es kommen also keine Daten mehr an. Die Implementierung bleibt im Adapter erhalten; sobald die API wieder nutzbar ist, wird das Profil erneut freigeschaltet. Für deutschlandweite Abfragen ist bis dahin motis:compat (Transitous) die Alternative.

Für den Fernverkehr der Deutschen Bahn nutzt der Adapter das Paket db-vendo-client. Dieses kommuniziert mit dem DB Vendo-System (offizielle DB-API) und deckt das gesamte Streckennetz der Deutschen Bahn ab.

Profil: db (aus db-vendo-client/p/db)

Verfügbare Verkehrsmittel: nationalExpress, national, regionalExpress, regional, suburban, bus, ferry, subway, tram, taxi

Hinweis: Das vendo:db-Profil ist speziell für das DB-Netz optimiert und lieferte häufig detailliertere Gleisangaben als HAFAS — solange die Sperre besteht, lässt es sich jedoch nicht nutzen.

Throttling

Auch dieser Client wird mit aktiviertem Throttling initialisiert.

---

MOTIS / Transitous (motis:compat)

Transitous ist ein community-betriebenes, Open-Source-Projekt für internationale Fahrplaninformationen basierend auf dem MOTIS-Server. Der Adapter nutzt das Paket @motis-project/motis-fptf-client mit dem compat-Profil.

Besonderheit: enrichStations ist deaktiviert, um das automatische Nachladen der DB-Haltestellendatenbank zu vermeiden.

Auch dieser Client wird mit aktiviertem Throttling (withThrottling) initialisiert, um die Rate der API-Anfragen zu begrenzen.

Verfügbare Verkehrsmittel: nationalExpress, national, regionalExpress, regional, suburban, bus, ferry, subway, tram

Hinweis: Transitous ist ein community-Dienst. Verfügbarkeit und Datenqualität können je nach Region variieren. In den abgedeckten Verbundgebieten und in Österreich liefern die dedizierten HAFAS-Profile in der Regel zuverlässigere Ergebnisse. Da vendo:db derzeit deaktiviert ist, ist motis:compat die einzige deutschlandweite Option.

---

Auswahl des richtigen Dienstes

Anwendungsfall	Empfehlung
Berlin/Brandenburg (inkl. S-Bahn/U-Bahn/Tram)	hafas:vbb
Österreich (ÖBB, Wiener Linien, etc.)	hafas:oebb
Bremen und Niedersachsen	hafas:vbn
Rhein-Main-Gebiet (Frankfurt, Wiesbaden, Mainz)	hafas:rmv
Thüringen	hafas:vmt
Deutschlandweiter Fernverkehr (ICE/IC/RE/RB)	motis:compat — vendo:db ist derzeit deaktiviert
DE & Europa / andere Länder	motis:compat

---

Weiterführende Seiten

• Konfiguration — Dienst und Profil auswählen
• Abfahrten — Verfügbare Verkehrsmittel je Profil
• Datenpunkte — Welche Daten der Adapter speichert