VBB Fahrinfo-API (HAFAS ReST 2.52)
Die Fahrinfo-API liefert Soll- und Echtzeitdaten des öffentlichen Verkehrs in Berlin und Brandenburg: Haltestellensuche, Abfahrts- und Ankunftstafeln, Verbindungsauskunft, Fahrtverläufe, Fahrzeugpositionen, Störungsmeldungen und Tarifinformationen. Die Schnittstelle basiert auf der HAFAS ReST-API von HaCon und ersetzt zum 30.11.2026 den bisherigen Endpunkt fahrinfo.vbb.de/restproxy (Version 2.49).
- Basis-URL Produktiv
- https://vbb.hafas.cloud/api/fahrinfo/latest
- Basis-URL Demo
- https://vbb.demo.hafas.cloud/api/fahrinfo/latest
- API-Version
- dialectVersion 2.52 (Server 2.52.1)
- Formate
- JSON, XML (Standard)
- Authentifizierung
- accessId (Query-Parameter)
- Fahrplanperiode
- 25.10.2026 – 11.12.2027
- Abgedeckt
- 38 Unternehmen · 7 Produktklassen
- Umstellung
- 30.11.2026
- Kontakt
- api@vbb.de
Schnellstart
Die meisten Anwendungen kommen mit drei Aufrufen aus: Ort finden, Abfahrten anzeigen, Verbindung suchen. Ersetzen Sie in allen Beispielen $ACCESS_ID durch Ihre persönliche Zugangskennung. Die Beispiele verwenden die Basis-URL des Produktivsystems; mit einer Kennung für das Demosystem ersetzen Sie vbb.hafas.cloud durch vbb.demo.hafas.cloud.
Haltestelle per Name suchen
Die Antwort enthält zu jeder Haltestelle die extId (z. B. 900100003 für S+U Alexanderplatz).
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/location.name?accessId=$ACCESS_ID&input=Alexanderplatz&type=S&maxNo=5&format=json"
Abfahrten an dieser Haltestelle abrufen
Die Abfahrtstafel enthält Soll- und Echtzeit, Linie, Richtung und Gleis bzw. Steig.
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/departureBoard?accessId=$ACCESS_ID&id=900100003&duration=30&format=json"
Verbindung zwischen zwei Haltestellen suchen
Hier vom Alexanderplatz zum Zoologischen Garten (900023201).
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/trip?accessId=$ACCESS_ID&originId=900100003&destId=900023201&format=json"
Authentifizierung und Zugang
Jede Anfrage an einen Datendienst muss die persönliche Zugangskennung im Query-Parameter accessId enthalten (max. 128 Zeichen). Bestehende Kennungen aus der Version 2.49 gelten auch für die neue Schnittstelle.
Zugang beantragen
Der Zugang erfolgt in zwei Stufen: Zum Entwickeln und Testen erhalten Sie eine Kennung für das Demosystem, für den laufenden Betrieb Ihrer Anwendung den Zugang zum Produktivsystem.
| Demosystem | Produktivsystem | |
|---|---|---|
| Basis-URL | https://vbb.demo.hafas.cloud/api/fahrinfo/latest | https://vbb.hafas.cloud/api/fahrinfo/latest |
| Zweck | Entwicklung, Tests, Ausprobieren | Stabiler privater oder öffentlicher Betrieb |
| Beantragung | Formlose E-Mail an api@vbb.de | Formular auf unternehmen.vbb.de |
| Bedingungen | Keine vorherige Zustimmung nötig | Zustimmung zu vier Bedingungen (siehe unten) |
| Anfragelimits | Strenger als im Produktivsystem | Individuell vereinbart |
Demosystem
Für den Einstieg genügt eine formlose E-Mail an api@vbb.de. Sie können die Schnittstelle dann unter https://vbb.demo.hafas.cloud/api/fahrinfo/latest sofort nutzen, ohne vorher Bedingungen zu akzeptieren. Das Demosystem bietet dieselben Services wie das Produktivsystem. Die Anfragelimits sind im Demosystem etwas strenger. Für den Betrieb einer Anwendung beantragen Sie anschließend den Zugang zum Produktivsystem.
Produktivsystem
Wenn Ihre Anwendung stabil läuft und privat oder öffentlich produktiv betrieben werden soll, beantragen Sie den Zugang zum Produktivsystem über das Formular auf unternehmen.vbb.de. Geben Sie dort Name bzw. Firma und E-Mail-Adresse an sowie, falls vorhanden, Ihre aktuelle Kennung für das Demosystem. Die Zugangsinformationen erhalten Sie per E-Mail.
Mit dem Antrag stimmen Sie vier Bedingungen zu:
| Bedingung | Inhalt |
|---|---|
| Datenstand | Der VBB erstellt die Daten sorgfältig, übernimmt aber keine Gewähr für Richtigkeit, Vollständigkeit und Aktualität. |
| Ausfallzeiten | Es besteht kein Anspruch auf Nutzung. Der VBB bemüht sich um einen unterbrechungsfreien Betrieb, kann Ausfälle aber nicht ausschließen. |
| Anfragevolumen | Anfragen sind effizient zu stellen. Bei übermäßiger Belastung kann der Zugang vorübergehend deaktiviert werden. |
| Datenquelle | Der VBB wird als Quelle der Fahrplandaten genannt, zum Beispiel in den AGB oder im Impressum Ihrer Anwendung. |
Maßgeblich ist der Wortlaut im Formular. Fragen zum Zugang richten Sie an api@vbb.de.
Anfragelimits
Im Produktivsystem wird die zulässige Anzahl an Anfragen für jede Kennung individuell mit dem VBB vereinbart; im Demosystem gelten etwas strengere Limits. Teilen Sie bei der Beantragung mit, welche Services Sie nutzen wollen und mit wie vielen Anfragen pro Tag und in Spitzenzeiten Sie rechnen. Wenn sich Ihr Bedarf ändert, etwa durch einen neuen Einsatzzweck oder deutlich mehr Nutzer*innen, melden Sie sich bitte vorab unter api@vbb.de.
| Situation | HTTP | errorCode |
|---|---|---|
accessId fehlt | 400 | API_PARAM · „Missing value for required param accessId“ |
accessId unbekannt oder gesperrt | 401 | API_AUTH · „access denied for … on departureBoard“ |
| Kennung nicht für diesen Service freigeschaltet | 401 | API_AUTH |
Kennung schützen. Die accessId ist an Sie gebunden. Bauen Sie sie nicht in öffentlich ausgelieferten Browser- oder App-Code ein, sondern rufen Sie die API über Ihren eigenen Server auf. Die URL einer Anfrage enthält die Kennung im Klartext; achten Sie darauf, dass sie nicht in öffentlich einsehbaren Logs landet.
Der Parameter aid (max. 64 Zeichen) überschreibt serverseitige Sicherheitseinstellungen und wird nur in Sonderkonfigurationen nach Absprache mit dem VBB benötigt.
Allgemeine Konventionen
Aufbau einer Anfrage
Alle Parameter werden als URL-Query übergeben und müssen URL-kodiert sein (insbesondere |, @, ×, Leerzeichen und Umlaute in IDs und Kontexten). Empfohlen ist GET; POST mit Query-Parametern wird ebenfalls angenommen.
Parameter, die jeder Service kennt
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
accessId Pflicht | string | – | Zugangskennung, max. 128 Zeichen. |
format | string | – | json oder xml. Ohne Angabe wird der Accept-Header ausgewertet, fehlt auch dieser, antwortet der Server mit XML. |
lang | string | de | Sprache für Texte und Hinweise, z. B. en („Handicap accessible“ statt „barrierefrei“). Haltestellen- und Richtungsnamen bleiben unverändert. |
requestId | string | – | Eigene Kennung zur Nachverfolgung, max. 2048 Zeichen. Wird in der Antwort als requestId zurückgegeben. |
aid | string | – | Siehe Authentifizierung. |
Datentypen und Schreibweisen
| Art | Format | Beispiel |
|---|---|---|
| Datum | YYYY-MM-DD | date=2026-11-03 |
| Uhrzeit | hh:mm[:ss], 24 h, Sekunden werden ignoriert | time=07:45 |
| Zeitzone | Alle Zeiten sind lokale Zeit Europe/Berlin | "time":"09:52:00" |
| Dauer (Antwort) | ISO 8601 | "duration":"PT12M" |
| Schalter | 0/1 oder false/true | passlist=1 |
| Koordinaten | WGS84, Dezimalgrad mit Punkt | originCoordLat=52.521508 |
| Listen | kommagetrennt | lines=U5,S3 |
| Ausschluss | ! vor dem Wert | categories=!Bus |
| Preise | Cent als Ganzzahl | "price":500 = 5,00 € |
Unbekannte Parameter werden ignoriert. Ein falsch geschriebener Filter (z. B. lineids am departureBoard, der dort nicht existiert) führt nicht zu einem Fehler, sondern zu einem ungefilterten Ergebnis. Prüfen Sie Parameternamen gegen die Tabellen in dieser Dokumentation oder die WADL. Ungültige Werte bekannter Parameter (z. B. duration=5000) werden dagegen mit 400 API_PARAM abgelehnt.
Antwortformat
Jede erfolgreiche JSON-Antwort enthält neben den Nutzdaten diese Metadaten:
{
"TechnicalMessages": { "TechnicalMessage": [ { "key": "requestTime", "value": "2026-11-03 09:49:46" } ] },
"serverVersion": "2.52.1",
"dialectVersion": "2.52",
"planRtTs": "2026-11-03T09:49:24.000+01:00"
}planRtTs ist der Zeitstempel des zuletzt eingespielten Echtzeitstands. Listen erscheinen in JSON immer als Array, auch bei nur einem Element. Felder ohne Wert werden weggelassen, nicht als null geliefert; behandeln Sie daher jedes Feld als optional.
Jede Antwort trägt außerdem einen Header X-Request-ID. Geben Sie diesen Wert bei Supportanfragen an.
Transport
- Kompression: Senden Sie
Accept-Encoding: gzip. Antworten werden dann komprimiert; bei den umfangreichen JSON-Antworten spart das einen Großteil der Datenmenge. - CORS: Der Server beantwortet Preflight-Anfragen und erlaubt Aufrufe aus dem Browser. Beachten Sie trotzdem den Hinweis zum Schutz der Kennung.
- Zeichensatz: UTF-8.
- Antwortzeiten: Einfache Abfragen benötigen meist unter einer Sekunde, Verbindungsauskünfte mit Tarif und Polylinien bis zu einige Sekunden. Setzen Sie Client-Timeouts nicht unter 10 Sekunden.
Haltestellen, Haltepunkte und IDs
Die Version 2.52 bildet die Haltestellen-Hierarchie des VBB vollständig ab. Das ist die wichtigste fachliche Neuerung gegenüber 2.49.
| Ebene | Begriff in der API | extId | Beispiel |
|---|---|---|---|
| Haltestelle | mainMast, isMainMast: true | 900xxxxxx | 900100003 S+U Alexanderplatz Bhf |
| Haltepunkt / Steig / Gleis | Mast, hasMainMast: true | 300xxxxxx | 300003233 S-Bahnsteig Gleis 3 |
In Antworten steht an Abfahrten, Ankünften, Fahrtabschnitten und Halten nun die Haltepunkt-ID (stopExtId: "300306026"). Die zugehörige Haltestelle finden Sie in mainMastExtId bzw. im eingebetteten Objekt mainMast:
{
"stop": "S+U Alexanderplatz Bhf/Gontardstr. (Berlin)",
"stopExtId": "300306026",
"hasMainMast": true,
"mainMastExtId": "900100026",
"altId": ["A×de:11000:900100026::1", "b×BVG_301008802"],
"mainMastAltId": ["A×de:11000:900100026", "b×BVG_100026"],
"track": "Pos. 15"
}Welche ID wofür?
- Als Eingabe (
id,originId,destId,viaId…) sind 9-stellige Haltestellen-IDs (900…) weiterhin die richtige Wahl. Haltepunkt-IDs (300…) werden ebenfalls akzeptiert. - Zum Speichern und Abgleichen eignen sich
mainMastExtIdoder die bundesweite DHID (Format IFOPT) ausaltIdmit PräfixA×, z. B.de:11000:900100003(Haltestelle) undde:11000:900100003:2:52(Steig). Die DHID steht zusätzlich als Hinweis mit SchlüsselIFin den Notes. - Der lange HAFAS-Lid-String (
"id": "A=1@O=…@L=900100003@…") kann als Eingabe verwendet werden, enthält aber Versionsanteile (@p=…) und eignet sich nicht zum dauerhaften Speichern.
Weitere Präfixe in altId: b× kennzeichnet unternehmensspezifische IDs (z. B. b×BVG_100026, b×DBS_8089001).
Linien und GlobalIds
Jedes Produkt (Product, ProductAtStop, productAtStop) enthält ab 2.52 ein Objekt LineInfo mit stabilen, systemübergreifenden Linien-IDs:
"LineInfo": {
"GlobalIds": [ { "id": "de:VBB:11000000|Tram|M4:", "type": "A" } ],
"lineId": "de:VBB:11000000|Tram|M4:"
}Zum Filtern nach diesen IDs dient der neue Parameter globallineids. Der Wert muss den Typ als Präfix tragen, getrennt durch das Zeichen × (U+00D7, URL-kodiert %C3%97):
…/departureBoard?accessId=$ACCESS_ID&id=900100003&format=json &globallineids=A%C3%97de%3AVBB%3A11000000%7CTram%7CM4%3A
Ohne Präfix keine Treffer. globallineids=de:VBB:11000000|Tram|M4: (ohne A×) liefert eine leere Tafel, keinen Fehler.
Für einfache Fälle genügt der Filter lines mit dem angezeigten Liniennamen (lines=U5).
Produktklassen
Der Parameter products ist eine Bitmaske. Addieren Sie die Werte der gewünschten Klassen: products=3 liefert S- und U-Bahn, products=127 alle Klassen. Die Farben stammen aus datainfo und können für die Darstellung verwendet werden.
| Bit | Klasse | catOut (Beispiele) | Farbe |
|---|---|---|---|
| 1 | S S-Bahn | S | #37874A |
| 2 | U U-Bahn | U | #003399 |
| 4 | Tram Tram | Tram | #CC0000 |
| 8 | Bus Bus (inkl. Rufbus, Kleinbus) | Bus | #993399 |
| 16 | F Fähre | Fähre | #0089C8 |
| 32 | FV Bahn-Fernverkehr | ICE, IC, EC, RJ, NJ, EN, TLK, RJX, DRF | #7D8185 |
| 64 | RE Bahn-Regionalverkehr | RE, RB, R, BKB | #E20019 |
Der Filter categories arbeitet mit den Kategorie-Codes (catOut), z. B. categories=!Bus für alles außer Bus. Linienfarben einzelner Linien (z. B. S3 #0066AD) stehen pro Produkt in icon.backgroundColor.
Verkehrsunternehmen
Der Filter operators akzeptiert das Kürzel (nameS) oder den vollen Namen. Die numerische id wird nicht als Filterwert erkannt. Die aktuelle Liste liefert datainfo; Stand 03.11.2026:
| Kürzel | Name | Kürzel | Name |
|---|---|---|---|
BVG | Berliner Verkehrsbetriebe | DBS | S-Bahn Berlin GmbH |
DB | DB Regio AG | ODE | ODEG Ostdeutsche Eisenbahn GmbH |
NEB | NEB Betriebsgesellschaft mbH | HAN | Hanseatische Eisenbahn |
MRB | Mitteldeutsche Regiobahn | FLX | FlixTrain GmbH |
goo | go.on Gesellschaft für Bus- und Schienenverkehr mbH | STE | Strausberger Eisenbahn GmbH |
BUK | Buckower Kleinbahn | SRS | Schöneicher Rüdersdorfer Straßenbahn GmbH |
ViP | Verkehrsbetrieb Potsdam GmbH | CV | Cottbusverkehr GmbH |
SVF | Stadtverkehrsgesellschaft mbH Frankfurt (Oder) | VBB | Verkehrsbetriebe Brandenburg an der Havel GmbH |
HAV | Havelbus Verkehrsgesellschaft mbH | reg | regiobus Potsdam Mittelmark GmbH |
OVG | Oberhavel Verkehrsgesellschaft mbH | BBG | Barnimer Busgesellschaft mbH |
VTF | Verkehrsgesellschaft Teltow-Fläming mbH | RVS | Regionale Verkehrsgesellschaft Dahme-Spreewald mbH |
VME | Verkehrsmanagement Elbe-Elster GmbH | VGO | Verkehrsgesellschaft Oberspreewald-Lausitz mbH |
mob | mobus Märkisch-Oderland Bus GmbH | BOS | Busverkehr Oder-Spree GmbH |
UVG | Uckermärkische Verkehrsgesellschaft mbH | ORP | ORP Ostprignitz-Ruppiner Personennahverkehrsgesellschaft mbH |
VGP | VG Prignitz mbH | SPN | Spree-Neiße-Cottbusverkehr |
DRO | DB Regio Bus Ost GmbH | PVG | Personenverkehrsgesellschaft Altmarkkreis Salzwedel mbH |
SDL | stendalbus | NJL | Nahverkehrsgesellschaft Jerichower Land mbH |
MWM | MWM-Solutions GmbH | Ang | Günter Anger Güterverkehrs GmbH & Co. Omnibusvermietung KG |
SCH | Busverkehr Gerd Schmidt | VET | Vetter GmbH |
Echtzeit
Wo Echtzeitdaten vorliegen, stehen sie neben den Solldaten in Feldern mit Präfix rt:
| Soll | Echtzeit | Bedeutung |
|---|---|---|
time, date | rtTime, rtDate | Abfahrts- bzw. Ankunftszeit |
track, platform | rtTrack, rtPlatform | Gleis / Steig |
depTime, arrTime | rtDepTime, rtArrTime | Zeiten an Zwischenhalten |
duration | rtDuration | Reisedauer einer Verbindung |
cancelled: truekennzeichnet ausgefallene Fahrten,partCancelledTeilausfälle,reachabledie Erreichbarkeit eines Anschlusses.prognosisTypegibt die Quelle an, z. B.PROGNOSED.JourneyStatus:P= planmäßige Fahrt. Weitere Werte kennzeichnen Ersatz-, Zusatz- und Sonderfahrten; die vollständige Liste steht im XML-Schema.- Mit
rtModesteuern Sie die Echtzeitberücksichtigung:OFF(reiner Fahrplan),SERVER_DEFAULT, beitrip/journeyDetailzusätzlichFULL,INFOS,REALTIME.
Tafeln berücksichtigen verspätete Fahrten: Eine um 09:46 geplante, auf 09:52 verspätete Abfahrt erscheint auch bei einer Anfrage um 09:50.
Alternative: GTFS-Realtime-Feed. Wenn Sie Echtzeitdaten für das gesamte Netz brauchen, statt einzelne Tafeln, Verbindungen oder Fahrten abzufragen, nutzen Sie den GTFS-RT-Feed des VBB unter https://production.gtfsrt.vbb.de/data. Er ergänzt den GTFS-Fahrplandatensatz des VBB um Echtzeitdaten. Den Fahrplandatensatz mit den reinen Solldaten laden Sie immer aktuell über vbb.de/gtfs.
- Der Feed braucht keine Zugangskennung und steht unter der Lizenz CC-BY 4.0.
- CORS ist aktiviert. Der Feed wird mit
ETagund auf Anfrage gzip- oder zstd-komprimiert ausgeliefert. - Die Zahl der Abrufe ist begrenzt. Das aktuelle Limit, Statusmeldungen (Atom-Feed
/news.atom.xml) und Hinweise zur Nutzung stehen auf production.gtfsrt.vbb.de. - Der Quellcode liegt auf GitHub unter OpenDataVBB.
Für Verbindungsauskünfte, Umgebungssuche, Fußwege und Störungsmeldungen bleibt diese Schnittstelle das passende Werkzeug.
Hinweise (Notes)
Haltestellen, Halte und Fahrten tragen Hinweise als Liste von { key, type, value, txtN, priority }. type: "A" sind Attribute für die Anzeige (z. B. Ausstattung), type: "I" sind interne oder technische Informationen. Beobachtete Schlüssel:
| key | Typ | Inhalt | Beispiel |
|---|---|---|---|
IF | I | DHID der Haltestelle bzw. des Steigs | de:11000:900100003:2:52 |
Nd / Ne | I | Steigbezeichnung lang, deutsch / englisch | „S-Bahnsteig Gleis 3“ / „Platform track 3“ |
Nf / Nu / NF | I | Steigbezeichnung kurz bzw. Varianten | „Tramsteig Gontardstraße ht. Rathausstraße Pos. 15“ |
SP | I | Steigposition | 15 |
LV | I | Ebene (Stockwerk) des Steigs | -3, 0, 1 |
BN | A | Steigbeschreibung für die Anzeige | „S-Bahnsteig Gleis 1“ |
RO / AU | A | Rolltreppe / Aufzug vorhanden | „Rolltreppe“, „Aufzug“ |
bf, B=, B- | A | Barrierefreiheit | „barrierefrei“, „nicht barrierefrei“ |
FB | A | Fahrradmitnahme möglich | „Fahrradmitnahme möglich“ |
QR | I | Haltestellen-QR-Code eines Unternehmens | BVG;308802 |
Die Liste ist nicht abschließend. Zeigen Sie unbekannte Attribute (type: "A") über txtN an, statt sie zu verwerfen. Mit baim=1 liefern trip, journeyDetail, Tafeln und gisroute zusätzliche Barrierefreiheits-Informationen (BAIM).
location.name: Orte nach Namen suchen
Findet Haltestellen, Adressen und Points of Interest zu einer Texteingabe. Typischer Einsatz: Autovervollständigung im Suchfeld, Auflösung von Haltestellennamen in IDs.
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
input Pflicht | string | – | Suchbegriff, max. 512 Zeichen. Teileingaben wie „Alexanderpl“ werden ergänzt. |
type | enum | ALL | S Haltestellen · A Adressen · P POI · SA, SP, AP Kombinationen · ALL alles |
maxNo | int | 10 | Maximale Trefferzahl, 1–1000. |
products | int | – | Nur Haltestellen mit diesen Produktklassen. |
operators neu | string | – | Nur Orte, die von diesen Unternehmen bedient werden. Negation mit !. |
coordLat, coordLong | double | – | Mittelpunkt, um Treffer in der Nähe zu bevorzugen oder einzuschränken. |
r | int | 1000 | Radius in Metern um coordLat/coordLong. |
filterMode | enum | DIST_PERI | DIST_PERI Nähe gewichtet · EXCL_PERI nur außerhalb · SLCT_PERI nur innerhalb des Radius. |
withEquivalentLocations | bool | false | Gleichwertige Haltestellen (gleicher Knoten) als equivalentStopLocation mitliefern. |
withProducts | bool | true | Liste der Linien je Haltestelle (productAtStop) mitliefern. Auf 0 setzen verkleinert die Antwort deutlich. |
productRepresentatives | bool | – | Pro Kategorie nur ein repräsentatives Produkt. |
locationSelectionMode | enum | – | SLCT_N normal · SLCT_A nur für Abfahrtstafeln geeignete Orte. |
restrictSelection | enum | S | Einschränkung erlaubter Stationen (S, D, I, V). |
stations | string | – | Nur IDs, die mit diesen Präfixen beginnen. |
sattributes | string | – | Filter auf Haltestellen-Attribute, Negation mit !. |
sinfotexts | string | – | Filter auf Infotexte, Format code|wert. |
meta | string | – | Vordefinierter Filter der Installation. |
poolId | string | – | Filter auf Pool-UIC-Codes. |
refineId | string | – | ID eines verfeinerbaren Treffers aus einer vorherigen Antwort. |
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/location.name?accessId=$ACCESS_ID&input=Zoologischer%20Garten&type=S&maxNo=3&withProducts=0&format=json"
{
"stopLocationOrCoordLocation": [
{
"StopLocation": {
"id": "A=1@O=S+U Zoologischer Garten Bhf (Berlin)@X=13332711@Y=52506919@U=86@L=900023201@p=1793325983@",
"extId": "900023201",
"name": "S+U Zoologischer Garten Bhf (Berlin)",
"lon": 13.332711,
"lat": 52.506919,
"weight": 24772,
"products": 107,
"isMainMast": true,
"altId": ["A×de:11000:900023201", "b×BVG_23201", "b×DBS_23201"],
"LocationNotes": { "LocationNote": [
{ "key": "IF", "type": "I", "value": "de:11000:900023201", "txtN": "de:11000:900023201" }
] }
}
},
{ "StopLocation": { "extId": "900023172", "name": "S+U Zoologischer Garten/Jebensstr. (Berlin)", "products": 8, "isMainMast": true } },
{ "StopLocation": { "extId": "900066102", "name": "S Botanischer Garten (Berlin)", "products": 9, "isMainMast": true } }
],
"serverVersion": "2.52.1",
"dialectVersion": "2.52"
}Adressen und POIs erscheinen als CoordLocation mit type ADR bzw. POI, Koordinaten und Namen. Für eine Verbindungsauskunft zu einer Adresse übergeben Sie deren lat/lon als originCoordLat/originCoordLong.
Antwortgröße. Ohne withProducts=0 enthält jeder Haltestellentreffer die vollständige Linienliste und gleichwertige Haltestellen. Für „Alexanderplatz“ mit 10 Treffern sind das über 200 KB. Für Autovervollständigung reicht withProducts=0.
location.nearbystops: Orte in der Umgebung
Liefert Haltestellen (und optional POIs) rund um eine Koordinate, sortiert nach Entfernung (dist in Metern).
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
originCoordLat Pflicht | double | – | Breitengrad des Mittelpunkts. |
originCoordLong Pflicht | double | – | Längengrad des Mittelpunkts. |
r | int | 1000 | Suchradius in Metern. |
maxNo | int | 10 | Maximale Trefferzahl, 1–1000. |
type | string | S | S Haltestellen · P POI · SP beides. |
products | int | – | Produkt-Bitmaske. |
date, time | string | jetzt | Bezugszeitpunkt für zeitabhängige Verfügbarkeit. |
duration neu | int | 40320 | Zeitraum in Minuten (1–40320), für den die Verfügbarkeit eines Orts geprüft wird. |
zoom | int | – | Kartenzoomstufe 0–21; liefert die für diese Zoomstufe relevantesten Haltestellen. |
poiCategories | string | – | POI-Kategorien, Negation mit !. |
locationSelectionMode, meta, poolId, sattributes, sinfotexts | Wie bei location.name. |
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/location.nearbystops?accessId=$ACCESS_ID&originCoordLat=52.521508&originCoordLong=13.411267&r=500&maxNo=10&format=json"
{
"stopLocationOrCoordLocation": [
{
"StopLocation": {
"extId": "300003233",
"name": "S+U Alexanderplatz Bhf (Berlin)",
"lon": 13.411223,
"lat": 52.521517,
"dist": 3,
"products": 67,
"hasMainMast": true,
"mainMastExtId": "900100003",
"altId": ["A×de:11000:900100003:2:52"],
"LocationNotes": { "LocationNote": [
{ "key": "Nd", "type": "I", "value": "S-Bahnsteig Gleis 3" },
{ "key": "Ne", "type": "I", "value": "Platform track 3" }
] }
}
},
{ "StopLocation": { "extId": "300003234", "name": "S+U Alexanderplatz Bhf (Berlin)", "dist": 10, "mainMastExtId": "900100003" } }
]
}Die Umgebungssuche liefert Haltepunkte (300…) mit Verweis auf ihre Haltestelle. Für eine Liste eindeutiger Haltestellen gruppieren Sie die Treffer nach mainMastExtId.
departureBoard: Abfahrtstafel
Liefert die Abfahrten an einer Haltestelle in einem Zeitfenster, mit Echtzeit, Gleis/Steig und optional dem weiteren Fahrtverlauf.
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| Ort und Zeit | |||
id Pflicht | string | – | Haltestellen- oder Haltepunkt-ID. extId ist veraltet, funktioniert aber weiterhin. |
date | string | heute | Startdatum YYYY-MM-DD. |
time | string | jetzt | Startzeit hh:mm. |
duration | int | 60 | Länge des Zeitfensters in Minuten, 0–1439. |
maxJourneys | int | -1 | Maximale Anzahl Abfahrten; -1 = alle im Zeitfenster. |
type | enum | DEP | DEP wie konfiguriert (Haltestelle inkl. aller Steige) · DEP_MAST nur der angefragte Haltepunkt · DEP_STATION alle Masten der Haltestelle · DEP_EQUIVS zusätzlich gleichwertige Haltestellen. |
| Filter | |||
products | int | – | Produkt-Bitmaske, z. B. 1 = nur S-Bahn. |
lines | string | – | Liniennamen, z. B. U5,S3; !M4 schließt aus. |
globallineids neu | string | – | Globale Linien-IDs mit Typpräfix, siehe Linien. |
operators | string | – | Unternehmen (Kürzel oder Name), Negation mit !. |
categories | string | – | Kategorien (catOut), Negation mit !. |
direction | string | – | Nur Fahrten, die über diese Haltestelle (ID) fahren. |
platforms | string | – | Nur diese Gleise/Steige, kommagetrennt. |
attributes | string | – | Fahrt-Attribute, Negation mit !. |
minDur | int | – | Mindestrestfahrzeit einer Fahrt in Minuten. |
| Ausgabe | |||
passlist | bool | false | Folgende Halte jeder Fahrt als Stops.Stop[] mitliefern. |
passlistMaxStops | int | – | Anzahl der Halte in der Passliste begrenzen. |
rtMode | enum | SERVER_DEFAULT | OFF schaltet Echtzeit ab. |
baim | bool | false | Barrierefreiheitsinformationen (BAIM). |
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/departureBoard?accessId=$ACCESS_ID&id=900100003&duration=30&maxJourneys=5&format=json"
…/departureBoard?accessId=$ACCESS_ID&id=900100003&products=1&format=json …/departureBoard?accessId=$ACCESS_ID&id=900100003&categories=!Bus&format=json …/departureBoard?accessId=$ACCESS_ID&id=900100003&lines=U5&format=json
{
"Departure": [
{
"name": "M4",
"type": "ST",
"stop": "S+U Alexanderplatz Bhf/Gontardstr. (Berlin)",
"stopExtId": "300306026",
"mainMastExtId": "900100026",
"lon": 13.411339,
"lat": 52.521032,
"time": "09:46:00",
"date": "2026-11-03",
"rtTime": "09:52:00",
"rtDate": "2026-11-03",
"prognosisType": "PROGNOSED",
"track": "Pos. 15",
"platform": { "type": "PL", "text": "Pos. 15" },
"direction": "S Hackescher Markt",
"directionFlag": "1",
"reachable": true,
"entry": true,
"JourneyStatus": "P",
"JourneyDetailRef": { "ref": "1|76836|0|86|3112026" },
"ProductAtStop": {
"name": "M4",
"displayNumber": "M4",
"line": "M4",
"lineId": "de:VBB:11000000|Tram|M4:",
"LineInfo": { "GlobalIds": [ { "id": "de:VBB:11000000|Tram|M4:", "type": "A" } ] },
"catOut": "Tram",
"cls": "4",
"operatorCode": "BVG",
"operator": "Berliner Verkehrsbetriebe",
"icon": { "backgroundColor": { "hex": "#CC0000" }, "foregroundColor": { "hex": "#FFFFFF" } }
},
"Notes": { "Note": [
{ "key": "FB", "type": "A", "value": "Fahrradmitnahme möglich", "priority": 350 },
{ "key": "bf", "type": "A", "value": "barrierefrei", "priority": 920 },
{ "key": "BN", "type": "A", "value": "Tramsteig Gontardstraße hinter Rathausstraße Position 15" }
] }
}
],
"serverVersion": "2.52.1",
"dialectVersion": "2.52",
"planRtTs": "2026-11-03T09:49:24.000+01:00"
}- Mit der ID einer Haltestelle (
900100003) enthält die Tafel alle Steige des Knotens, auch Tram- und Busstationen in der Umgebung, sofern sie zur Haltestelle gehören. Für einen einzelnen Bahnsteig fragen Sie die Haltepunkt-ID mittype=DEP_MASTab. JourneyDetailRef.refverwenden Sie fürjourneyDetail.- Sortiert wird nach Sollzeit. Wer nach tatsächlicher Abfahrt sortieren möchte, sortiert clientseitig nach
rtTime(falls vorhanden, sonsttime).
arrivalBoard: Ankunftstafel
Gegenstück zur Abfahrtstafel. Parameter und Filter sind identisch mit departureBoard, mit diesen Unterschieden:
type:ARR(Standard),ARR_MAST,ARR_STATION,ARR_EQUIVS.- Die Antwort enthält
Arrival[]stattDeparture[]; stattdirectionsteht die Herkunft inorigin. - Der Parameter
directionfiltert hier auf Fahrten, die von der angegebenen Haltestelle kommen.
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/arrivalBoard?accessId=$ACCESS_ID&id=900100003&duration=30&maxJourneys=3&format=json"
{
"Arrival": [
{
"name": "M4",
"stop": "S+U Alexanderplatz Bhf/Gontardstr. (Berlin)",
"stopExtId": "300306026",
"mainMastExtId": "900100026",
"time": "09:46:00",
"date": "2026-11-03",
"rtTime": "09:52:00",
"rtDate": "2026-11-03",
"track": "Pos. 15",
"origin": "Zingster Str. (Berlin)",
"reachable": true,
"entry": true,
"JourneyDetailRef": { "ref": "1|76836|0|86|3112026" },
"ProductAtStop": { "name": "M4", "catOut": "Tram", "cls": "4", "operatorCode": "BVG" }
}
]
}trip: Verbindungsauskunft
Berechnet Verbindungen zwischen zwei Orten (Haltestelle, Adresse oder Koordinate), optional über Zwischenhalte, mit Echtzeit, Tarif, Fußwegen und Polylinien.
Start und Ziel
Pro Ende genau eine Variante angeben:
- Haltestelle:
originId/destId(z. B.900100003) - Koordinate:
originCoordLat+originCoordLongbzw.destCoordLat+destCoordLong, optional mitoriginCoordName/destCoordNameals Anzeigename
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| Start, Ziel, Via | |||
originId, destId | string | – | Haltestellen-ID. originExtId/destExtId sind veraltet. |
originCoordLat/Long, destCoordLat/Long | double | – | Koordinaten (WGS84). |
originCoordName, destCoordName | string | – | Anzeigename, falls die Koordinate nicht aufgelöst werden kann. |
originCoordType, destCoordType | enum | – | A, ALL, C, P, S |
viaId | string | – | Haltestelle, über die gefahren werden muss. |
viaWaitTime | int | 0 | Aufenthalt am Via-Halt in Minuten. |
via | string | – | Mehrere Via-Punkte, durch ; getrennt (komplexe Struktur). |
viaGis | string | – | Via-Orte für Individualverkehrsabschnitte. |
avoidId, avoid | string | – | Haltestelle(n), an denen nicht umgestiegen werden soll. |
| Zeit und Umfang | |||
date, time | string | jetzt | Abfahrtszeitpunkt. |
searchForArrival | bool | false | 1: date/time gelten als gewünschte Ankunft. |
numF | int | 5 | Mindestanzahl Verbindungen nach dem Suchzeitpunkt, 1–6. |
numB | int | 0 | Mindestanzahl Verbindungen davor, 0–5. numF + numB ≤ 6. |
context | string | – | Blättern: Wert aus scrF (später) oder scrB (früher) der vorigen Antwort. |
includeEarlier | bool | false | Optimierung nach Reisedauer abschalten, frühere Abfahrten zulassen. |
| Verkehrsmittel und Linien | |||
products | int | – | Produkt-Bitmaske. |
lines, lineids, globallineids neu | string | – | Linienfilter (Name / lineId / GlobalId mit Präfix), Negation mit !. |
operators, categories, categoryFlags | string | – | Unternehmen, Kategorien, Kategorie-Flags. |
attributes, sattributes, fattributes | string | – | Fahrt-, Haltestellen- und Fußweg-Attribute. |
mobilityProfile | string | – | Mobilitätsprofil für die barrierefreie Suche: limitedBarrierfree (bedingt barrierefrei) oder completeBarrierfree (voll barrierefrei). |
groupFilter | string | – | Vordefinierte Filter der Installation. |
trainFilter | string | – | Suche auf einen bestimmten Zug einschränken. |
bikeCarriage | bool | false | Nur Verbindungen mit Fahrradmitnahme. |
bikeCarriageType | enum | – | SINGLEBIKES, SMALLGROUPS, LARGEGROUPS |
sleepingCar, couchetteCoach | bool | false | Nur Verbindungen mit Schlaf- bzw. Liegewagen. |
includeDrt | bool | true | Bedarfsverkehre (Rufbus, On-Demand) einbeziehen. |
| Umstiege | |||
maxChange | int | – | Maximale Anzahl Umstiege, 0–11. |
minChangeTime, maxChangeTime | int | – | Minimale / maximale Umstiegszeit in Minuten. |
addChangeTime | int | – | Zusätzliche Minuten an jedem Umstieg. |
changeTimePercent | int | 100 | Umstiegszeiten skalieren; 200 verdoppelt sie (langsameres Gehen). |
withICTAlternatives | bool | false | Alternativen mit individuellen Umstiegszeiten suchen. |
blockedEdges, blockingList, avoidPaths | string | – | Netzabschnitte oder Pfadeigenschaften ausschließen. |
| Fußweg, Rad, Auto (Zu- und Abgang) | |||
originWalk, destWalk, totalWalk | string | – | Fußwege am Start, am Ziel bzw. für die gesamte Strecke steuern. |
originBike, destBike, totalBike | string | – | Fahrradabschnitte. |
originCar, destCar, totalCar | string | – | Autoabschnitte. |
originTaxi, destTaxi, totalTaxi | string | – | Taxiabschnitte. |
originPark, destPark | string | – | Park+Ride. |
originMeta, destMeta, totalMeta | string | – | Vordefinierte Profile für Individualverkehr. |
includeIv, ivOnly | bool | false | Reine Individualverkehrsrouten zusätzlich bzw. ausschließlich. |
gisProducts | string | – | Sharing-Anbieter ausschließen (!code). |
allowFootpathEquivalences | bool | true | Bei abgeschaltetem Fußweg gleichwertige, per Fußpfad verbundene Haltestellen erlauben. |
| Ausgabe | |||
passlist | bool | false | Zwischenhalte je Abschnitt. |
showPassingPoints | bool | false | Auch Durchfahrten ohne Halt (benötigt passlist). |
poly | bool | false | Polylinien je Abschnitt. |
polyEnc | enum | N | N unkodiert · DLT Delta · GPA Google Encoded Polyline. |
tariff | bool | Konfig. | Tarifauskunft (TariffResult). |
trafficMessages | bool | Konfig. | Störungsmeldungen je Verbindung. |
withFreq | bool | true | Taktinformationen (Freq). |
withJourneyBoundaryPoints | bool | false | Start- und Endhalt der gesamten Fahrt je Abschnitt. |
trainComposition | bool | false | Zugbildung, soweit vorhanden. |
baim | bool | false | Barrierefreiheitsinformationen; zusammen mit mobilityProfile für die barrierefreie Suche. |
rtMode | enum | – | FULL, INFOS, OFF, REALTIME, SERVER_DEFAULT |
| Sonstiges | |||
economic, unsharp | bool | false | Sparsamer bzw. unscharfer Suchmodus. |
travellerProfileData | string | – | Reisendenprofil (Struktur installationsabhängig). |
eco, ecoCmp, ecoParams | false | Umweltwerte. eco/ecoCmp sind veraltet. | |
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/trip?accessId=$ACCESS_ID&originId=900100003&destId=900023201&numF=2&format=json"
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/trip?accessId=$ACCESS_ID\ &originCoordLat=52.5163&originCoordLong=13.3777&originCoordName=Brandenburger%20Tor\ &destCoordLat=52.3906&destCoordLong=13.0645\ &numF=1&poly=1&tariff=1&format=json"
{
"Trip": [
{
"idx": 0,
"tripId": "C-0",
"duration": "PT51M",
"Origin": { "name": "Brandenburger Tor", "type": "ADR", "time": "09:57:00", "date": "2026-11-03" },
"Destination": { "name": "52.390600, 13.064500", "type": "ADR", "time": "10:48:00" },
"LegList": { "Leg": [
{ "type": "WALK", "name": "Fußweg", "dist": 295, "duration": "PT4M",
"Origin": { "name": "Brandenburger Tor", "time": "09:57:00" },
"Destination": { "name": "S+U Brandenburger Tor (Berlin)", "extId": "300223072", "time": "10:01:00" },
"GisRef": { "ref": "¶G|1|G@F|A=2@O=Brandenburger Tor@…" } },
{ "type": "JNY", "name": "S26", "direction": "S Blankenburg (Berlin)", "duration": "PT1M",
"Origin": { "name": "S+U Brandenburger Tor (Berlin)", "extId": "300223072", "time": "10:01:00", "track": "2" },
"Destination": { "name": "S+U Friedrichstr. Bhf (Berlin)", "extId": "300005612", "time": "10:02:00" },
"JourneyDetailRef": { "ref": "1|8579|6|86|3112026|C:B" },
"Product": [ { "name": "S26", "catOut": "S", "cls": "1", "LineInfo": { "GlobalIds": [ "…" ] } } ],
"minimumChangeDuration": "PT0S" },
{ "type": "WALK", "name": "Fußweg", "dist": 81, "duration": "PT2M",
"Origin": { "name": "S+U Friedrichstr. Bhf (Berlin)", "extId": "300005612", "time": "10:02:00" },
"Destination": { "name": "S+U Friedrichstr. Bhf (Berlin)", "extId": "300005466", "time": "10:04:00" } },
{ "type": "JNY", "name": "S7", "direction": "S Potsdam Hauptbahnhof", "duration": "PT38M",
"Origin": { "extId": "300005466", "time": "10:04:00", "track": "6" },
"Destination": { "name": "S Potsdam Hauptbahnhof", "extId": "300501057", "time": "10:42:00" },
"JourneyDetailRef": { "ref": "1|4700|0|86|3112026|C:B" } },
{ "type": "WALK", "name": "Fußweg", "dist": 296, "duration": "PT6M" }
] },
"TariffResult": { "fareSetItem": [
{ "name": "Berlin Tarifgebiet A-B-C: Einzelfahrausweis", "desc": "Via: Berlin ABC",
"fareItem": [
{ "name": "Regeltarif", "price": 500, "cur": "EUR" },
{ "name": "Ermäßigungstarif", "price": 350, "cur": "EUR" },
{ "name": "Fahrrad", "price": 330, "cur": "EUR" }
] },
{ "name": "Berlin Tarifgebiet A-B-C: 4-Fahrten-Karte", "fareItem": [ { "name": "Regeltarif", "price": 1680, "cur": "EUR" } ] }
] },
"ctxRecon": "¬¶BAIM¶t¬¶HKI¶T$A=1@O=S+U Brandenburger Tor (Berlin)@L=300223072@…",
"checksum": "…"
}
],
"scrB": "3|OB|MTµ14µ16433µ…",
"scrF": "3|OF|MTµ14µ16438µ…",
"serverVersion": "2.52.1",
"dialectVersion": "2.52"
}Aufbau einer Verbindung
LegList.Leg[]enthält die Abschnitte.type:JNYFahrt mit einem Verkehrsmittel,WALKFußweg; bei aktiviertem Individualverkehr zusätzlich Typen wieBIKEoderTAXI. Behandeln Sie unbekannte Typen als generischen Abschnitt.- Umstiege innerhalb großer Bahnhöfe erscheinen als eigener
WALK-Abschnitt zwischen zwei Haltepunkten (oben: 81 m in Friedrichstraße). GisRef.refeines Fußwegs liefert übergisroutedie Wegbeschreibung.ctxReconbeschreibt die Verbindung als Kontext. Behandeln Sie den Wert als undurchsichtig und kurzlebig.scrF/scrBalscontextübergeben, um spätere bzw. frühere Verbindungen zu laden.
Polylinien
Mit poly=1 enthält jeder Fahrtabschnitt PolylineGroup.polylineDesc[].crd, Fußwege GisRoute.polylineGroup. crd ist eine flache Liste [lon, lat, lon, lat, …]. Mit polyEnc=GPA erhalten Sie stattdessen eine Google-Encoded-Polyline (crdEncS), was die Antwort deutlich verkleinert.
Barrierefreie Verbindungssuche
Für mobilitätseingeschränkte Reisende sucht trip Verbindungen, die nur Wege nutzen, die für das gewählte Profil geeignet sind. Übergeben Sie dazu baim=1 und ein Mobilitätsprofil in mobilityProfile. Die beiden Profile entsprechen den Auswahlmöglichkeiten der VBB-Fahrinfo:
mobilityProfile | VBB-Fahrinfo | Wirkung |
|---|---|---|
limitedBarrierfree | bedingt barrierefrei | Wege ohne feste Treppen; Rolltreppen sind erlaubt. |
completeBarrierfree | voll barrierefrei | Wege ohne Treppen und Rolltreppen, zum Beispiel über Aufzüge. |
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/trip?accessId=$ACCESS_ID&originId=900100003&destId=900023201\ &baim=1&mobilityProfile=completeBarrierfree&numF=3&format=json"
Die Antwort hat denselben Aufbau wie eine normale Verbindungsauskunft. Zusätzlich beschreibt die Verbindung den Weg innerhalb der Bahnhöfe: Vor und nach der Fahrt stehen eigene WALK-Abschnitte vom Zugang zum Bahnsteig, deren GisRoute.seg[] Aufzüge oder Rolltreppen benennt. Dieselbe Fahrt von Alexanderplatz zum Zoologischen Garten am Vormittag:
| Suche | Erste Verbindung | Weg zum Bahnsteig am Alexanderplatz |
|---|---|---|
| ohne Profil | S7, 13 Min. | nicht ausgewiesen |
limitedBarrierfree | Fußweg 1 Min. · S9 · Fußweg 2 Min., 16 Min. | „Bahnhofshalle Rolltreppe zum Bahnsteig Gleis 3+4“, „Rolltreppe aufwärts“ |
completeBarrierfree | Fußweg 3 Min. · S3 · Fußweg 3 Min., 20 Min. | „Bahnhofshalle Aufzug zum Bahnsteig Gleis 3+4“, „Aufzug aufwärts“ |
completeBarrierfree){
"type": "WALK", "name": "Fußweg", "duration": "PT3M", "dist": 89,
"Origin": { "name": "S+U Alexanderplatz Bhf (Berlin)", "extId": "300003304", "time": "09:01:00" },
"Destination": { "name": "S+U Alexanderplatz Bhf (Berlin)", "extId": "300003234", "time": "09:04:00" },
"GisRoute": { "seg": [
{ "man": "NO", "manTx": "Fußweg", "dist": 7 },
{ "man": "NO", "manTx": "Bahnhofshalle Aufzug zum Bahnsteig Gleis 3+4" },
{ "man": "NO", "manTx": "Aufzug aufwärts", "dist": 0 },
{ "man": "NO", "manTx": "Bahnsteig Gleis 3+4 Aufzug zur Bahnhofshalle" },
{ "man": "NO", "manTx": "Fußweg", "dist": 82 }
] }
}- Fahrtabschnitte tragen weiterhin den Hinweis
bf(„barrierefrei“) bzw. „nicht barrierefrei“, siehe Hinweise. - Barrierefreie Verbindungen sind oft etwas länger, weil Aufzüge oder andere Zugänge Umwege bedeuten.
- Für langsameres Gehen lassen sich die Umstiegszeiten zusätzlich mit
changeTimePercentverlängern.
Profilnamen exakt schreiben. Ein unbekannter Wert in mobilityProfile wird ohne Fehlermeldung ignoriert; die Antwort ist dann eine normale, nicht barrierefreie Verbindungssuche. Auch baim=1 allein ändert die Suche nicht. Entscheidend ist das Profil.
journeyDetail: Fahrtverlauf
Liefert den vollständigen Laufweg einer einzelnen Fahrt (Zug, Bus, Tram) mit allen Halten, Soll- und Echtzeiten, Gleisen und Hinweisen.
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
id Pflicht | string | – | Wert aus JourneyDetailRef.ref einer Tafel, Verbindung oder Fahrzeugposition, URL-kodiert. |
date | string | – | Betriebstag. |
fromId, toId | string | – | Nur den Teil zwischen diesen Haltestellen liefern. |
fromIdx, toIdx | int | – | Wie oben, über die Position im Laufweg (routeIdx). |
poly, polyEnc | false, N | Polylinie der Fahrt. | |
showPassingPoints | bool | false | Auch Durchfahrten ohne Halt. |
rtMode, baim | Wie bei trip. |
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/journeyDetail?accessId=$ACCESS_ID&id=1%7C1954%7C5%7C86%7C3112026&format=json"
{
"ref": "1|1954|5|86|3112026|C:B",
"dayOfOperation": "2026-11-03",
"reachable": true,
"JourneyStatus": "P",
"Directions": { "Direction": [ { "value": "S Spandau Bhf (Berlin)", "flag": "1", "routeIdxFrom": 0, "routeIdxTo": 29 } ] },
"Product": [ { "name": "S3", "catOut": "S", "lineId": "de:VBB:11000000|S-Bahn|S3:S3-B", "operatorCode": "DBS" } ],
"Stops": { "Stop": [
{ "name": "S Erkner Bhf", "extId": "300269032", "routeIdx": 0,
"depTime": "09:14:00", "rtDepTime": "09:14:00", "depTrack": "32" },
{ "name": "S Wilhelmshagen (Berlin)", "extId": "300268001", "routeIdx": 1,
"arrTime": "09:17:00", "depTime": "09:17:00", "arrTrack": "1",
"Notes": { "Note": [ { "key": "BN", "type": "A", "value": "S-Bahnsteig Gleis 1" } ] } },
"… 27 weitere Halte …",
{ "name": "S Spandau Bhf (Berlin)", "routeIdx": 29, "arrTime": "10:26:00" }
] },
"ServiceDays": [ {
"planningPeriodBegin": "2026-10-25", "planningPeriodEnd": "2027-12-11",
"sDaysR": "nicht täglich", "sDaysI": "3. bis 25. Nov 2026 Mo - Fr",
"sDaysB": "1CF9F3E70000…"
} ]
}Referenzen sind nicht dauerhaft. JourneyDetailRef.ref gilt nur für den Betriebstag und den aktuellen Datenstand und ist nicht zwischen Systemen austauschbar. Referenzen aus der alten Schnittstelle 2.49 werden mit 400 SVC_PARAM abgelehnt. Holen Sie die Referenz immer frisch aus einer aktuellen Antwort.
gisroute: Fußweg- und Individualverkehrsroute
Liefert zu einem Fuß-, Rad- oder Autoabschnitt einer Verbindung die detaillierte Route mit Abbiegehinweisen, Distanzen und Polylinie.
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
ctx Pflicht | string | – | Wert aus Leg.GisRef.ref, URL-kodiert. |
poly | bool | false | Polylinie mitliefern. |
polyEnc | enum | N | N, DLT, GPA. |
baim | bool | false | Barrierefreiheitsinformationen (z. B. Treppen, Aufzüge). |
eco | bool | false | Umweltwerte. |
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/gisroute?accessId=$ACCESS_ID&poly=1&format=json&ctx=%C2%B6G%7C1%7CG%40F%7CA%3D2%40O%3DBrandenburger%20Tor…"
{
"Trip": [ {
"Origin": { "name": "Brandenburger Tor", "type": "ADR", "lon": 13.3777, "lat": 52.5163, "time": "09:57:00" },
"Destination": { "name": "S+U Brandenburger Tor (Berlin)", "extId": "300223072" },
"LegList": { "Leg": [ {
"type": "WALK", "dist": 295, "duration": "PT4M",
"GisRoute": {
"seg": [
{ "dist": 158, "man": "FR", "manTx": "Start", "ori": "E", "polyS": 0, "polyE": 11 },
{ "dist": 0, "man": "TO", "manTx": "Ankunft", "ori": "N", "polyS": 11, "polyE": 12 },
{ "man": "NO", "manTx": "Zugang B Unter den Linden Pariser Platz, Treppe zum Zwischengeschoss", "ori": "U" }
],
"polylineGroup": { "polylineDesc": [ { "dim": 2, "delta": false,
"crd": [13.3777, 52.5163, 13.377704, 52.51627, 13.377752, 52.516273, "…"] } ] }
}
} ] }
} ]
}man ist der Manövertyp, manTx der Anzeigetext, ori die Himmelsrichtung (N, E, … sowie U/D für Ebenenwechsel). polyS/polyE verweisen auf Indizes in der Polylinie. Neu in 2.52: Segmente können eigene Notes tragen, etwa zu Zugängen.
journeypos: Fahrzeugpositionen
Liefert Fahrzeuge, die sich in einem Kartenausschnitt (Bounding Box) befinden, mit Position, Fahrtverlauf und interpolierter Bewegung. Typischer Einsatz: Live-Karten.
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
llLat, llLon Pflicht | double | – | Untere linke Ecke der Box. |
urLat, urLon Pflicht | double | – | Obere rechte Ecke der Box. |
positionMode | enum | REPORT_ONLY | REPORT_ONLY nur gemeldete GPS-Positionen · CALC_REPORT gemeldet, sonst berechnet · CALC alle Positionen aus dem Fahrplan berechnet. |
maxJny | int | 1000 | Maximale Anzahl Fahrzeuge, 1–1000. |
date, time | string | jetzt | Bezugszeitpunkt. |
periodSize | int | 30000 | Vorschauzeitraum für Bewegungen in Millisekunden. |
periodStep | int | 2000 | Schrittweite der Bewegungspunkte in Millisekunden. |
products, lines, globallineids neu, operators, attributes, infotexts, jid | string | – | Filter nach Produkt, Linie, Unternehmen, Attributen, Infotexten oder Fahrt-ID. |
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/journeypos?accessId=$ACCESS_ID&llLat=52.51&llLon=13.39&urLat=52.53&urLon=13.42&products=1&positionMode=CALC&maxJny=50&format=json"
{
"Journey": [ {
"name": "S3",
"direction": "S Spandau Bhf (Berlin)",
"lon": 13.400831, "lat": 52.522407,
"trainCategory": "S-4",
"JourneyDetailRef": { "ref": "1|1954|5|86|3112026" },
"Product": { "name": "S3", "catOut": "S", "lineId": "de:VBB:11000000|S-Bahn|S3:S3-B" },
"JourneyPath": { "JourneyPathItem": [
{ "progressInTime": 0, "progressInPercent": 10, "dirGeo": 16, "state": "O",
"fromLocationId": "A=1@O=S Hackescher Markt (Berlin)@…@L=300212074@",
"toLocationId": "A=1@O=S+U Friedrichstr. Bhf (Berlin)@…@L=300005466@" },
{ "progressInTime": 2000, "progressInPercent": 11, "dirGeo": 16, "state": "O" }
] },
"Stops": { "Stop": [ { "name": "S Erkner Bhf", "depTime": "09:14:00" }, "…" ] }
} ],
"planningPeriodBegin": "2026-10-25",
"planningPeriodEnd": "2027-12-11"
}Leere Antwort im Standardmodus. Mit positionMode=REPORT_ONLY (Standard) erscheinen nur Fahrzeuge, die aktiv GPS-Positionen melden; das Ergebnis kann dann leer sein. Für eine vollständige Karte CALC_REPORT verwenden.
Rufen Sie den Service für Live-Karten höchstens alle 15–30 Sekunden auf und animieren Sie dazwischen clientseitig über JourneyPath.
himsearch: Störungs- und Baustellenmeldungen
Durchsucht die HAFAS-Informations-Manager-Meldungen (HIM): Bauarbeiten, Störungen, Umleitungen, Hinweise zu Haltestellen und Linien.
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| Zeitraum | |||
dateB, timeB | string | – | Beginn des Ereigniszeitraums (YYYY-MM-DD, hh:mm). |
dateE, timeE | string | – | Ende des Ereigniszeitraums. |
weekdays | string | – | Bitmaske der Wochentage ab Montag, z. B. 1111100. |
| Betroffene Objekte | |||
lines, lineids, globallineids neu | string | – | Meldungen zu diesen Linien. |
stations | string | – | Meldungen zu diesen Haltestellen-IDs. |
fromstation, tostation, bothways | string / bool | – | Meldungen zu einem Streckenabschnitt, optional in beiden Richtungen. |
operators, companies | string | – | Unternehmen bzw. meldende Stelle (! schließt aus). |
categories, trainnames | string | – | Zuggattungen, Zugnamen. |
llLat, llLon, urLat, urLon | double | – | Bounding Box. |
regions | string | – | Regionen aus datainfo. |
| Meldungsart | |||
himIds | string | – | Bestimmte Meldungen per ID. |
himcategory | string | – | Kategorie, z. B. Baustelle oder Störung (Werte installationsabhängig). |
channels | string | – | Ausgabekanäle, z. B. TIMETABLE, HIM_STATION_MONITOR. |
minprio, maxprio | int | – | Prioritätsbereich. |
himtext, exthimtext | string | – | Freitextsuche. |
himtags, himtexttags, metas, additionalfields, extInfo, searchmode | string | – | Erweiterte Filter (installationsabhängig). |
| Ausgabe | |||
orderBy | string | – | EVT_BEG_ASC, EVT_BEG_DESC, EVT_END_ASC/DESC, PRIO_ASC/DESC, LMOD_ASC/DESC, HID_ASC/DESC, kommagetrennt kombinierbar. |
hierarchicalView | bool | false | Übergeordnete Meldungen mit Unterelementen. |
affectedJourneyMode, affectedJourneyStopMode | string | – | Ausgabe betroffener Fahrten und ihrer Halte. |
poly, polyEnc | false | Geometrie betroffener Abschnitte. | |
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/himsearch?accessId=$ACCESS_ID&lines=S3&dateB=2026-11-03&dateE=2026-11-30&orderBy=PRIO_DESC&format=json"
{
"Message": [ {
"id": "HIM_FREETEXT_351247",
"act": true,
"head": "Bauarbeiten.",
"text": "Der Zug fällt zwischen Bad Schandau und Schöna aus. Bitte prüfen Sie Ihre Reiseverbindung kurz vor der Abfahrt des Zuges.",
"company": "VBB",
"category": "1",
"messageCategory": [ { "id": 1, "name": "Baustelle" } ],
"priority": 5,
"icon": "him_gen_constr",
"sDate": "2026-11-03", "sTime": "06:47:00",
"eDate": "2026-11-05", "eTime": "19:25:00",
"modDate": "2026-07-21", "modTime": "22:08:42",
"channel": [ { "name": "TIMETABLE", "validFromDate": "2026-07-21", "validToDate": "2026-11-05" } ],
"affectedProduct": [ { "name": "S3", "cls": "1", "operatorCode": "DBS" } ],
"affectedStops": { "StopLocation": [ { "extId": "900245026", "name": "Dahlewitz, Bahnhof" } ] },
"event": [ { "sDate": "2026-10-25", "eDate": "2026-11-05", "sTime": "06:47:00", "eTime": "19:25:00" } ]
} ]
}Datenstand vor der Umstellung. Bis zum Wechsel am 30.11.2026 liefert himsearch nur eine Testmeldung. Die produktiven Störungsmeldungen werden zum Wechsel angeschlossen. Bis dahin liefert eine Anfrage wie oben im neuen System keine solchen Meldungen.
Immer filtern. Eine Anfrage ohne Filter liefert sämtliche aktiven Meldungen und kann mehrere Megabyte groß werden. Schränken Sie mindestens nach Linie, Haltestelle, Zeitraum oder Bounding Box ein.
datainfo: Stammdaten der Installation neu
Liefert die Stammdaten, die Sie für Filter und Darstellung brauchen: Verkehrsunternehmen, Produkte mit Farben, Produktkategorien, Regionen sowie die Fahrplanperiode. Keine weiteren Parameter außer den allgemeinen.
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/datainfo?accessId=$ACCESS_ID&format=json"
{
"Operator": [
{ "id": "796", "name": "Berliner Verkehrsbetriebe", "nameS": "BVG", "nameN": "BVG",
"url": "https://www.bvg.de/", "administration": ["BVB---", "BVF---", "BVT---", "BVU---"] },
{ "id": "1", "name": "S-Bahn Berlin GmbH", "nameS": "DBS", "url": "https://sbahn.berlin/" }
],
"Product": [
{ "name": "S-Bahn", "cls": "1", "catOut": "S", "catIn": "S-5", "catOutL": "S",
"icon": { "res": "prod_gen", "backgroundColor": { "hex": "#37874A" }, "foregroundColor": { "hex": "#FFFFFF" } } }
],
"ProductCategory": [ { "name": "S-Bahn", "cls": "1", "Product": [ … ] } ],
"Region": [ { "name": "DRT_BVG__N95", "extId": 1000 } ],
"begin": "2026-10-25",
"end": "2027-12-11",
"serverVersion": "2.52.1",
"dialectVersion": "2.52"
}Die Daten ändern sich selten. Laden Sie sie beim Start Ihrer Anwendung und cachen Sie sie für einen Tag.
wadl und xsd: Maschinenlesbare Beschreibung
Für jeden Service steht eine WADL-Beschreibung aller Parameter bereit, für die Antwortstrukturen ein XML-Schema. Beide sind ohne Zugangskennung abrufbar und eignen sich zur Code-Generierung und zur Prüfung von Parameternamen.
| Ressource | URL |
|---|---|
| Übersicht aller Services | https://vbb.hafas.cloud/api/fahrinfo/latest/ |
| WADL eines Service | https://vbb.hafas.cloud/api/fahrinfo/latest/{service}?wadl, z. B. …/trip?wadl |
| XML-Schema | https://vbb.hafas.cloud/api/fahrinfo/latest/xsd/rest-2.52.xsd |
Die Service-Namen in der WADL-URL entsprechen den Pfaden: arrivalBoard, datainfo, departureBoard, gisroute, himsearch, journeyDetail, journeypos, location.nearbystops, location.name, trip. Jeder Parameter trägt in der WADL die Versionsnummer, seit der er existiert.
Fehlerbehandlung
Fehler werden als Objekt mit errorCode und errorText geliefert. Fehler aus der Fahrplanberechnung enthalten zusätzlich internalErrorCode und einen anzeigefähigen Text internalErrorTextOut.
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=UTF-8
{
"serverVersion": "2.52.1",
"dialectVersion": "2.52",
"errorCode": "SVC_LOC",
"errorText": "location missing or invalid (LOCATION).",
"internalErrorCode": "LOCATION",
"internalErrorText": "HCI Service: location missing or invalid",
"internalErrorTextOut": "Während der Suche ist ein interner Fehler aufgetreten",
"requestId": "default-request-id"
}| errorCode | HTTP | Bedeutung | Was tun? |
|---|---|---|---|
API_AUTH | 401 | Kennung ungültig, gesperrt oder für den Service nicht freigeschaltet | Kennung prüfen, ggf. Freischaltung bei api@vbb.de anfragen |
API_PARAM | 400 | Pflichtparameter fehlt oder Wert außerhalb des erlaubten Bereichs | errorText nennt den Parameter |
SVC_PARAM | 400 | Parameter fachlich ungültig, z. B. abgelaufene Fahrtreferenz | Referenz neu abrufen |
SVC_LOC | 400 | Ort unbekannt oder ungültig | ID über location.name prüfen |
SVC_LOC_DEP / SVC_LOC_ARR | 400 | Start bzw. Ziel fehlt oder ist ungültig | Start-/Zielparameter prüfen |
SVC_DATATIME_PERIOD | 400 | Datum außerhalb der Fahrplanperiode | Periode über datainfo ermitteln |
SVC_DATATIME | 400 | Datum/Zeit fehlt oder ist ungültig, auch bei unlesbarem ctx in gisroute | Kontext frisch aus trip holen |
SVC_NO_RESULT | 200 | Anfrage gültig, aber keine Verbindung gefunden | Hinweis anzeigen, Suche anpassen |
| (ohne) | 5xx | Server- oder Gateway-Fehler | Mit Backoff wiederholen |
Drei Stolperfallen.
SVC_NO_RESULTkommt mit HTTP 200. Prüfen Sie bei jeder Antwort, oberrorCodegesetzt ist, nicht nur den Statuscode.- Fehler, die vor der Auswertung von
formatentstehen (fehlende Kennung, ungültigerformat-Wert), kommen als XML, auch wenn JSON angefordert wurde. Werten Sie denContent-Typeaus, bevor Sie parsen, oder senden Sie zusätzlichAccept: application/json. - Eine leere Ergebnisliste ist kein Fehler: Eine Tafel ohne Abfahrten liefert einfach kein
Departure-Feld. - Ein ungültiger Blätter-Kontext (
contextintrip) wird ohne Fehlermeldung ignoriert; Sie erhalten dann eine neue Suche ab jetzt statt der erwarteten späteren Verbindungen.
Gute Praxis
- Kennung serverseitig halten. Bauen Sie einen schlanken Proxy, der die
accessIdergänzt und Antworten cacht. - Caching.
datainfo: 24 h. Haltestellensuche: Stunden. Abfahrtstafeln: höchstens 30 s. Verbindungen: nicht über die Sitzung hinaus. - Autovervollständigung drosseln. Senden Sie
location.nameerst ab drei Zeichen und mit 250–300 ms Verzögerung nach dem letzten Tastendruck; nutzen SiewithProducts=0. - Antworten klein halten.
maxJourneys,maxNo,passlist=0undpolyEnc=GPAreduzieren Datenmenge und Antwortzeit. - Gzip aktivieren (
Accept-Encoding: gzip). - IDs richtig speichern. Haltestellen über
mainMastExtIdoder DHID, nie über Namen oder den Lid-String. Referenzen (JourneyDetailRef,ctxRecon,GisRef,scrF/scrB) als undurchsichtige, kurzlebige Werte behandeln. - Tolerant parsen. Neue Felder können jederzeit hinzukommen, optionale Felder fehlen. Listen sind in JSON immer Arrays.
- Wiederholungen mit Backoff. Bei 5xx-Antworten oder Timeouts höchstens zweimal mit wachsendem Abstand wiederholen, bei 4xx nicht.
- Vereinbarte Anfragelimits einhalten. Cachen und drosseln Sie so, dass Ihre Anwendung auch in Spitzenzeiten innerhalb der für Ihre Kennung vereinbarten Menge bleibt. Bei übermäßiger Belastung kann der VBB den Zugang vorübergehend deaktivieren.
- Netzweite Echtzeit über GTFS-RT. Fragen Sie nicht viele Tafeln oder Fahrten in Schleifen ab, um ein Gesamtbild des Netzes zu bekommen. Dafür ist der GTFS-RT-Feed gedacht.
requestIdsetzen und zusammen mit dem Response-HeaderX-Request-IDloggen. Geben Sie bei Supportanfragen an api@vbb.de beide Werte, die vollständige Anfrage-URL ohneaccessIdund den Zeitpunkt an.- Quellenangabe. Nennen Sie den VBB als Quelle der Fahrplandaten, zum Beispiel in den AGB oder im Impressum Ihrer Anwendung. Das ist eine der Bedingungen für den Zugang zum Produktivsystem.
- Mit Ausfällen rechnen. Es gibt keinen Anspruch auf unterbrechungsfreie Verfügbarkeit. Zeigen Sie bei Fehlern oder Timeouts einen verständlichen Hinweis an, statt die Anwendung abstürzen zu lassen, und greifen Sie, wo es passt, auf zwischengespeicherte Solldaten zurück.
Changelog: 2.49 → 2.52
Die bisherige Schnittstelle unter https://fahrinfo.vbb.de/restproxy/latest (Version 2.49) wird am 30.11.2026 durch https://vbb.hafas.cloud/api/fahrinfo/latest (Version 2.52) ersetzt. Stellen Sie Ihre Anwendung bis zu diesem Datum um; die neue Schnittstelle ist bereits jetzt erreichbar. Pfade, Service-Namen und die meisten Parameter bleiben gleich, die Zugangskennung gilt weiter. Grundlage dieses Changelogs ist ein Vergleich der WADL- und XSD-Beschreibungen beider Versionen sowie paralleler Abfragen am 03.11.2026.
Breaking Changes
- geändertBasis-URL.
fahrinfo.vbb.de/restproxy/latest→vbb.hafas.cloud/api/fahrinfo/latest. - geändertHaltepunkt-IDs in Antworten.
stopExtIdan Abfahrten und Ankünften,extIdan Halten, Fahrtabschnitten und inlocation.nearbystopsenthalten jetzt Haltepunkt-IDs (300…) statt Haltestellen-IDs (900…). Die Haltestelle steht in den neuen FeldernmainMastExtId/mainMast. Code, derstopExtIdmit gespeicherten 900er-IDs vergleicht, muss aufmainMastExtIdumgestellt werden. Als Eingabe bleiben 900er-IDs gültig. - geändertHaltestellenstruktur in den Daten. Tram- und Bushaltestellen an großen Knoten sind eigenständige Haltestellen. Beispiel Alexanderplatz:
productssinkt von79auf67(nur S, U, Regionalverkehr); Tram und Bus liegen an900100005,900100031usw. Die Abfahrtstafel einer Haltestelle enthält diese weiterhin. - entferntJSONP.
format=jsonpundjsonpCallbackwerden nicht mehr unterstützt (400 API_PARAM). Verwenden Sieformat=jsonmit CORS. - geändertNotes-Schlüssel. Ausstattungsattribute haben neue Schlüssel: Rolltreppe
FT→RO, AufzugAT→AU. Weitere Schlüssel sind entfallen oder hinzugekommen (siehe Hinweise). Wer auf Schlüssel filtert, muss die Zuordnung prüfen. - geändertReferenzen und Kontexte.
JourneyDetailRef.ref,ctxRecon,GisRef.refundscrB/scrFaus 2.49 sind im neuen System ungültig. Das Format hat sich teils geändert (z. B. Suffix|C:Ban Fahrtreferenzen austrip, Präfix¶G|/¶H|anGisRef,¬¶BAIM¶…anctxRecon). Gespeicherte Verbindungen müssen nach der Umstellung neu gesucht werden. - geändertAdressnamen. Adress-Treffer enthalten keine Postleitzahl mehr: „Karl-Marx-Allee 1, 10178 Berlin-Mitte“ → „Karl-Marx-Allee 1, Berlin-Mitte“.
Neu
- neuService
datainfomit Unternehmen, Produkten, Farben, Kategorien, Regionen und Fahrplanperiode. In 2.49 nicht verfügbar. - neuParameter
globallineidsindepartureBoard,arrivalBoard,trip,journeypos,himsearch(Filter nach globaler Linien-ID mit TyppräfixA×). - neuParameter
operatorsinlocation.name. - neuParameter
durationinlocation.nearbystops(Verfügbarkeitszeitraum, 1–40320 min). - neuHaltestellen-Hierarchie: Felder
hasMainMast,isMainMast,mainMast,mainMastId,mainMastExtId,mainMastAltId,mainMastLat,mainMastLonan Orten, Abfahrten, Ankünften und Abschnitten. - neu
LineInfomitGlobalIds[]undlineIdan allen Produkten. - neu
equivalentStopLocation[]inlocation.name(gleichwertige Haltestellen eines Knotens). - neuSteiginformationen: Hinweise
Nd,Ne,Nf,Nu,NF(Steigbezeichnung de/en),SP(Position),LV(Ebene); DHID auf Steigebene inaltId. - neuUmstiegswege: Umstiege zwischen Steigen eines Bahnhofs erscheinen als eigener
WALK-Abschnitt; Abschnitte tragenminimumChangeDuration. - neuZugangsinformationen als
NotesanGisRoute.seg[](z. B. „Zugang B Unter den Linden Pariser Platz, Treppe zum Zwischengeschoss“). - neuWeitere Felder:
entryan Abfahrten/Ankünften,checksumDtiundchecksumSavean Verbindungen. - neuSchema-Erweiterungen (XSD 2.52, noch nicht in allen Antworten befüllt):
globalIdan Fahrten, Abschnitten und Unternehmen;OriginStop/DestinationStopan Abfahrten und Ankünften; Auslastung mit StatusL/M/H/U/NAund Echtzeitwerten (sRt,vRt,rawRt); Geo-Feature-TypenGEO_REGION,PARKING_ZONE. - neuHTTP: Response-Header
X-Request-ID;POSTwird angenommen (2.49:405).
Entfernt
- entfernt
format=jsonp,jsonpCallback(alle Services). - entfernt
requestIdin jeder Antwort. 2.49 lieferte immer eine generierterequestId. 2.52 liefert sie nur noch, wenn Sie selbstrequestIdmitsenden; zur Nachverfolgung dient der HeaderX-Request-ID. - entfernt
Occupancy(AuslastungFIRST/SECONDmitraw) ist in Tafeln, Verbindungen, Fahrtverläufen und Fahrzeugpositionen derzeit nicht enthalten; die Anbindung ist voraussichtlich zum Wechsel vorgesehen. Siehe offene Punkte. - entfernt
rtPlatform/rtTrackan Ankünften in Stichproben nicht mehr enthalten; Sollgleistrack/platformbleibt. - entferntTechnische Meldung
backendInfoinTechnicalMessages. - entfernt
gisroute:Trip.duration,Trip.dist,Trip.ctxRecon,Trip.checksum,TripStatussowieedgeHashR/edgeHashSauf Trip-Ebene; Dauer und Distanz stehen weiterhin am Abschnitt (Leg.duration,Leg.dist).
Geändertes Verhalten
- geändertUmgebungssuche.
location.nearbystopsliefert Haltepunkte statt Haltestellen und in Stichproben deutlich weniger Treffer als 2.49 (Alexanderplatz, 500 m: 2 statt 10 Treffer). Der Fehler ist gemeldet und wird behoben; siehe offene Punkte. - geändertVerspätete Fahrten auf Tafeln. Abfahrten mit Sollzeit vor dem Anfragezeitpunkt, deren Echtzeit danach liegt, werden aufgenommen.
- geändertTreffer und Ranking in
location.nameunterscheiden sich durch die neue Haltestellenstruktur (andereweight-Werte, andere Reihenfolge). - geändertKoordinatennamen in
trip:originCoordName/destCoordNamewird übernommen; 2.49 ersetzte ihn häufig durch einen nahegelegenen POI („Berlin, Brandenburger Tor“). - geändertFehlerantworten bei fehlender Kennung oder ungültigem
formatkommen als XML, auch beiformat=json. - geändertÜbersichtsseite. 2.49 lieferte für unbekannte Pfade (z. B.
/wadl,/datainfo) die Service-Übersicht als HTML mit Status 200. 2.52 antwortet auf unbekannte Pfade mit404; die Übersicht liegt unter/latest/, die WADL je Service unter/{service}?wadl.
Offene Punkte (Stand 03.11.2026)
- Störungsmeldungen:
himsearchliefert im neuen System derzeit nur eine Testmeldung (2.49: 862 aktive Meldungen). Die produktiven Meldungen werden zum Wechsel am 30.11.2026 angeschlossen. - Umgebungssuche:
location.nearbystopsliefert unabhängig vonrnur Haltepunkte der nächstgelegenen Haltestelle, an manchen Koordinaten kein Ergebnis. Der Fehler ist gemeldet und wird behoben. - Auslastung: Auslastungsdaten (
Occupancy) fehlen derzeit. Sie werden voraussichtlich ebenfalls zum Wechsel am 30.11.2026 angeschlossen.
Migrations-Checkliste
- Basis-URL austauschen. Die
accessIdbleibt gleich. - JSONP-Aufrufe auf
format=jsonumstellen (CORS ist aktiv). - Überall, wo Sie Haltestellen aus Antworten mit gespeicherten IDs vergleichen,
mainMastExtIdstattstopExtId/extIdverwenden (Fallback aufextId, wennhasMainMastfehlt). - Ergebnisse von
location.nearbystopsnachmainMastExtIdgruppieren. - Auswertungen von Notes-Schlüsseln (
FT,AT…) auf die neuen Schlüssel prüfen. - Gespeicherte
ctxRecon, Fahrtreferenzen und Blätter-Kontexte verwerfen und neu erzeugen. - Abhängigkeiten von
requestIdin Antworten undbackendInfoentfernen.Occupancyals optional behandeln, bis die Auslastung angeschlossen ist. - Fehlerbehandlung um
Content-Type-Prüfung ergänzen (XML-Fehler bei JSON-Anfragen). - Optional: Linienfilter auf
globallineidsumstellen, Stammdaten überdatainfoladen statt hart zu kodieren. - Alte und neue Schnittstelle parallel abfragen und Ergebnisse vergleichen, bevor Sie umschalten.
- Spätestens am 30.11.2026 produktiv auf die neue Basis-URL umschalten.
Fragen zur Umstellung richten Sie an api@vbb.de.