Willkommen im Bereich ÖPNV

Hier bieten wir Euch Daten rund um das Thema ÖPNV an.
Es handelt sich dabei um Basisdaten mit Informationen zu Haltestellen, Linien und Fahrzeugen, sowie Live-Daten zu Fahrzeugen und Haltestellen.
Wir würden uns sehr freuen, wenn damit gearbeitet und Neues geschaffen wird.
Schreibt uns auch gerne unter verkehrstechnik@swu.de, was Ihr damit für Ideen umsetzt oder ob wir da noch etwas verbessern können.
Die Daten sind natürlich kostenlos (CC-0-Lizenz).
Wir können euer Feedback kaum erwarten.

Datenformat und Aufteilung der Daten

Die Schnittstelle liefert die Daten im JSON-Format.

Es werden Daten für die verschiedenen Elemente aus dem Bereich ÖPNV geliefert.
Jedes Element liefert Daten zu den für sich zutreffenden Eigenschaften.
Diese Aufteilung spiegelt sich in der URL wieder.
Beispiel:
Haltestelle - Fahrten - aktuelle Abfahrten
https://.../stop/passage/Departures

Alle Anfragen verwenden HTTP GET.

Version

Die aktuelle Version ist 1.0

Die Version wird über die URL angegeben.
https://.../v1/...

Unter /mobility/v1/VersionInfo können Infos zur aktuellen Version im JSON-Format abgerufen werden.

Dort sind auch die Datentypen der einzelnen Daten beschrieben.

Basisdaten: Linie

Anfrage:
GET /mobility/v1/route/attributes/BaseData

Optionale Parameter:
ContentScope=minimal / basic / extended
RouteNumber=Liniennummer

Basisdaten: Haltestelle

Anfrage: GET /mobility/v1/stop/attributes/BaseData

Optionale Parameter:
ContentScope=minimal / basic / extended
StopNumber=Haltestellennummer

Basisdaten: Haltepunkt (Steig einer Haltestelle)

Anfrage: GET /mobility/v1/stoppoint/attributes/BaseData

Optionale Parameter:
ContentScope=minimal / basic / extended
StopPointCode=Haltepunktcode

Basisdaten: Fahrzeug

Anfrage: GET /mobility/v1/vehicle/attributes/BaseData

Optionale Parameter:
ContentScope=minimal / basic / extended
VehicleNumber=Fahrzeugnummer

Livedaten: Haltestelle - Abfahrten

Anfrage: GET /mobility/v1/stop/passage/Departures

Erforderlicher Parameter:
StopNumber=Haltestellennummer (4-stellig)

Empfohlender Parameter:
Limit=Anzahl der Fahrten

Livedaten: Haltestelle - Ankünfte

Anfrage: GET /mobility/v1/stop/passage/Arrivals

Erforderlicher Parameter:
StopNumber=Haltestellennummer (4-stellig)

Empfohlender Parameter:
Limit=Anzahl der Fahrten

Livedaten: Haltepunkt - Abfahrten

Anfrage: GET /mobility/v1/stoppoint/passage/Departures

Erforderlicher Parameter:
StopPointCode=Haltepunktcode (6-stellig)

Empfohlender Parameter:
Limit=Anzahl der Fahrten

Livedaten: Haltepunkt - Ankünfte

Anfrage: GET /mobility/v1/stoppoint/passage/Arrivals

Erforderlicher Parameter:
StopPointCode=Haltepunktcode (6-stellig)

Empfohlender Parameter:
Limit=Anzahl der Fahrten

Livedaten: Fahrzeug - Fahrt

Anfrage: GET /mobility/v1/vehicle/trip/Trip

Optionaler Parameter:
VehicleNumber=Fahrzeugnummer

Livedaten: Fahrzeug - Reise

Anfrage: GET /mobility/v1/vehicle/trip/Passage

Erforderlicher Parameter:
VehicleNumber=Fahrzeugnummer

Optionaler Parameter:
Range=all / upcomming

Livedaten: Fahrzeug - Fahrweg

Anfrage: GET /mobility/v1/vehicle/trip/Pattern

Erforderlicher Parameter:
VehicleNumber=Fahrzeugnummer

Optionaler Parameter:
ContentScope=Stops / Track / Carriageway

Welcome to public transport section

Here we offer you data on all aspects of public transport.
This is basic data with information on stops, lines and vehicles as well as live data on vehicles and stops.
We would be very happy if you work with it and create something new.
You are also welcome to write to us at verkehrstechnik@swu.de about what ideas you are implementing with them or whether we can still improve something.
Of course we offer this data for free (CC-0-license).
We can't wait for your feedback.

Format and layout of data

The API provides data in JSON-Format.

Data from the different elements in the public transport section is provided.
Every element has data for its specific attribute.
This layout can be seen in the URL.
Example:
Stops - Passage - Departures
https://.../stop/passage/Departures

All requests use HTTP GET.

Version

Current version is 1.0

The version is specified within the URL.
https://.../v1/...

See /mobility/v1/VersionInfo for detailed version information in JSON-format.

Datatypes of the response are also described in this JSON.

Basedata: Route

Request:
GET /mobility/v1/route/attributes/BaseData

Optional parameters:
ContentScope=minimal / basic / extended
RouteNumber=Routenumber

Basedata: Stop

Request: GET /mobility/v1/stop/attributes/BaseData

Optional parameters:
ContentScope=minimal / basic / extended
StopNumber=Stopnumber

Basedata: StopPoint (Platform of Stop)

Request: GET /mobility/v1/stoppoint/attributes/BaseData

Optional parameters:
ContentScope=minimal / basic / extended
StopPointCode=Stoppointcode

Basedata: Vehicle

Request: GET /mobility/v1/vehicle/attributes/BaseData

Optional parameters:
ContentScope=minimal / basic / extended
VehicleNumber=Vehiclenumber

Livedata: Stop - Departures

Request: GET /mobility/v1/stop/passage/Departures

Required parameter:
StopNumber=Stopnumber (4-digits)

Recommended parameter:
Limit=Number of departures

Livedata: Stop - Arrivals

Request: GET /mobility/v1/stop/passage/Arrivals

Required parameter:
StopNumber=Stopnumber (4-digits)

Recommended parameter:
Limit=Number of arrivals

Livedata: StopPoint - Departures

Request: GET /mobility/v1/stoppoint/passage/Departures

Required parameter:
StopPointCode=Stoppointcode (6-digits)

Recommended parameter:
Limit=Number of departures

Livedata: StopPoint - Arrivals

Request: GET /mobility/v1/stoppoint/passage/Arrivals

Required parameter:
StopPointCode=Stoppointcode (6-digits)

Recommended parameter:
Limit=Number of arrivals

Livedata: Vehicle - Trip

Request: GET /mobility/v1/vehicle/trip/Trip

Optional parameter:
VehicleNumber=Vehiclenumber

Livedaten: Vehicle - Passage

Request: GET /mobility/v1/vehicle/trip/Passage

Required parameter:
VehicleNumber=Vehiclenumber

Optional parameter:
Range=all / upcomming

Livedaten: Vehicle - Pattern

Request: GET /mobility/v1/vehicle/trip/Pattern

Required parameter:
VehicleNumber=Vehiclenumber

Optional parameter:
ContentScope=Stops / Track / Carriageway