Verbindungsauskunft (`/plan`)

Liefert Verbindungen mit Bus und Bahn zwischen zwei Orten — nach Fahrplan, mit Umstiegen, Fußwegen und Linienbezeichnungen.

GET https://valhalla.pixelmap.at/opnv/api/v5/plan

Beispiel

Klagenfurt Hauptbahnhof → Villach:

curl -H "Authorization: Bearer <IHR-TOKEN>" -G "https://valhalla.pixelmap.at/opnv/api/v5/plan" \
  --data-urlencode "fromPlace=46.6165,14.3179" \
  --data-urlencode "toPlace=46.6103,13.8558"

Gemessen am 14.09.2026: 5 Verbindungen, die erste mit 55 Minuten und einem Umstieg.

Antwort

{
  "from": { … },
  "to": { … },
  "itineraries": [
    {
      "duration": 3300,
      "transfers": 1,
      "startTime": "…",
      "endTime": "…",
      "legs": [
        { "mode": "WALK",          "from": {"name": "START"},        "to": {"name": "Klagenfurt Hbf"} },
        { "mode": "REGIONAL_RAIL", "from": {"name": "Klagenfurt Hbf"}, "to": {"name": "Villach Hbf"}, "routeShortName": "RJ" },
        { "mode": "WALK",          "from": {"name": "Villach Hbf"},  "to": {"name": "Villach Hauptbahnhof"} },
        { "mode": "BUS",           "from": {"name": "Villach Hauptbahnhof"}, "to": {"name": "Villach Trattengasse"}, "routeShortName": "1" }
      ]
    }
  ],
  "direct": [ … ],
  "nextPageCursor": "…",
  "previousPageCursor": "…"
}

Feld	Bedeutung
itineraries[]	Die Verbindungen, beste zuerst
duration	Gesamtdauer in Sekunden
transfers	Anzahl der Umstiege
legs[]	Die Teilstücke der Reihe nach
legs[].mode	WALK, BUS, REGIONAL_RAIL, TRAM, …
legs[].routeShortName	Linienbezeichnung, bei Fußwegen null
direct	Verbindungen ganz ohne ÖPNV (zu Fuß, Rad)

Blättern

nextPageCursor und previousPageCursor liefern die nächsten bzw. vorherigen Abfahrten. Geben Sie den Wert als pageCursor mit, statt die Uhrzeit selbst weiterzurechnen — der Dienst weiß besser, wo das nächste Fenster beginnt.

Zeitpunkt

Ohne Zeitangabe rechnet der Dienst ab jetzt. Für eine bestimmte Abfahrt oder Ankunft geben Sie time (ISO-8601) und arriveBy mit.

Eine ÖPNV-Auskunft ohne Zeitpunkt ist nur die halbe Frage

Fahrpläne sind tageszeit- und wochentagsabhängig. Eine Verbindung, die Dienstagmittag in 55 Minuten steht, kann Sonntagfrüh doppelt so lange dauern oder gar nicht existieren. Wenn Sie Ergebnisse zwischenspeichern, gehört der Zeitpunkt in den Schlüssel.

Fußwege am Anfang und Ende

Die erste und letzte Etappe sind fast immer WALK — von der übergebenen Koordinate zur Haltestelle. from.name ist dort START bzw. das Ziel heißt wie der eingegebene Punkt, nicht wie eine Haltestelle.

Auffällig im gemessenen Beispiel: zwischen „Villach Hbf” und „Villach Hauptbahnhof” liegt ein Fußweg — zwei Namen für denselben Ort aus verschiedenen Datenquellen (Bahn und Bus). Das ist normal in ÖPNV-Daten und kein Fehler; rechnen Sie in Ihrer Oberfläche damit, dass ein Umstieg „am selben Ort” als Fußweg erscheint.