en Services

Transport Services

The adapter supports three different transport service backends, selected via the profile dropdown in Configuration. All three services implement the same internal interface and provide the same datapoints.

---

Overview

Service	Profile selection	npm package	Region
HAFAS – VBB	hafas:vbb	hafas-client	Berlin/Brandenburg
HAFAS – ÖBB	hafas:oebb	hafas-client	Austria
HAFAS – VBN	hafas:vbn	hafas-client	Bremen/Lower Saxony
HAFAS – RMV	hafas:rmv	hafas-client	Rhine-Main/Mainz
HAFAS – VMT	hafas:vmt	hafas-client	Thuringia
Deutsche Bahn (Vendo) — currently disabled	vendo:db	db-vendo-client	Germany
MOTIS/Transitous	motis:compat	@motis-project/motis-fptf-client	Germany & Europe

---

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

HAFAS is the widely-used timetable information system of many European transport associations. The adapter uses the open-source hafas-client package, which provides HAFAS profiles for numerous operators.

The adapter includes five pre-configured profiles:

VBB – Verkehrsverbund Berlin-Brandenburg (hafas:vbb)

Covers public transport in Berlin and Brandenburg (S-Bahn, U-Bahn, tram, bus, ferry, regional/express rail).

Available products: suburban, subway, tram, bus, ferry, express, regional

ÖBB – Austrian Federal Railways (hafas:oebb)

Covers public transport in Austria (ICE/Railjet, IC/EC, Interregio, regional trains, S-Bahn, bus, ferry, subway, tram, on-call services).

Available products: nationalExpress, national, interregional, regional, suburban, bus, ferry, subway, tram, onCall

VBN – Verkehrsverbund Bremen/Niedersachsen (hafas:vbn)

Covers public transport in Bremen and Lower Saxony.

Available products: expressTrain, nationalTrain, localTrain, suburban, bus, watercraft, subway, tram, dialARide

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

Covers public transport in the Rhine-Main region (Frankfurt, Wiesbaden, Mainz, Hesse).

Available products: expressTrain, longDistanceTrain, regionaTrain, sBahn, uBahn, tram, bus, watercraft, ast, cableCar

Note: RMV uses its own product IDs (s-bahn, u-bahn, long-distance-train, regiona-train, cable-car) instead of the ones known from VBB/ÖBB. The adapter maps them to the camelCase keys above — regionaTrain is not a typo but matches the HAFAS product ID regiona-train.

VMT – Verkehrsverbund Mittelthüringen (hafas:vmt)

Covers public transport in Thuringia.

Available products: longDistanceTrain, regionalTrain, tram, bus

Throttling

All HAFAS clients are initialised with throttling enabled (withThrottling) to limit the rate of API requests and avoid being blocked by the service.

Client Name

The client name is used in the HTTP User-Agent of API requests. It is composed of:

{clientName}-{random number 0–1000}

The clientName can optionally be configured in Settings. Default: iobroker-public-transport.

---

Deutsche Bahn – Vendo (vendo:db) — currently disabled

This profile has been disabled since adapter version 0.10.0 and cannot be selected in the profile dropdown. Deutsche Bahn's db-vendo endpoint answers the adapter's requests with OPS_BLOCKED (server-side block), so no data arrives any more. The implementation stays in the adapter; the profile will be re-enabled once the API is usable again. Until then, motis:compat (Transitous) is the alternative for Germany-wide queries.

For Deutsche Bahn long-distance services, the adapter uses the db-vendo-client package. This communicates with the DB Vendo system (official DB API) and covers the entire Deutsche Bahn network.

Profile: db (from db-vendo-client/p/db)

Available products: nationalExpress, national, regionalExpress, regional, suburban, bus, ferry, subway, tram, taxi

Note: The vendo:db profile is specifically optimised for the DB network and used to provide more detailed platform information than HAFAS — but it cannot be used while the block is in place.

Throttling

This client is also initialised with throttling enabled.

---

MOTIS / Transitous (motis:compat)

Transitous is a community-operated, open-source project for international timetable information based on the MOTIS server. The adapter uses the @motis-project/motis-fptf-client package with the compat profile.

Special feature: enrichStations is disabled to avoid automatically loading the DB stop database.

This client is also initialised with throttling enabled (withThrottling) to limit the rate of API requests.

Available products: nationalExpress, national, regionalExpress, regional, suburban, bus, ferry, subway, tram

Note: Transitous is a community service. Availability and data quality may vary by region. Within the covered transport associations and in Austria, the dedicated HAFAS profiles generally provide more reliable results. Since vendo:db is currently disabled, motis:compat is the only Germany-wide option.

---

Choosing the Right Service

Use case	Recommendation
Berlin/Brandenburg (incl. S-Bahn/U-Bahn/Tram)	hafas:vbb
Austria (ÖBB, Wiener Linien, etc.)	hafas:oebb
Bremen and Lower Saxony	hafas:vbn
Rhine-Main region (Frankfurt, Wiesbaden, Mainz)	hafas:rmv
Thuringia	hafas:vmt
Germany-wide long-distance (ICE/IC/RE/RB)	motis:compat — vendo:db is currently disabled
Germany & Europe / other countries	motis:compat

---

Related Pages

• Configuration — Select service and profile
• Departures — Available products per profile
• Datapoints — What data the adapter stores

---

Home