Erreichbarkeit (`/one-to-all`)

Beantwortet „was erreiche ich von hier aus in n Minuten mit Bus und Bahn?” — als Liste erreichbarer Orte, nicht als Fläche.

GET https://valhalla.pixelmap.at/opnv/api/v1/one-to-all

Beispiel

Alles, was von Klagenfurt Hauptbahnhof in 30 Minuten erreichbar ist:

curl -H "Authorization: Bearer <IHR-TOKEN>" -G "https://valhalla.pixelmap.at/opnv/api/v1/one-to-all" \
  --data-urlencode "one=46.6165,14.3179" \
  --data-urlencode "maxTravelTime=30" \
  --data-urlencode "arriveBy=false"

Antwort

{
  "one": {
    "lat": 46.6165, "lon": 14.3179,
    "departure": "2026-09-14T14:45:00Z",   // „jetzt", vom Dienst auf 15 min gerundet
    "vertexType": "NORMAL"
  },
  "all": [
    { "place": { "name": "Klagenfurt Ostbahnhof", "stopId": "at55v27822_at:42:3641:…" }, … }
  ]
}

all ist die Liste der erreichbaren Haltestellen samt Reisezeit. one wiederholt den Ausgangspunkt und — wichtig — den tatsächlich verwendeten Abfahrtszeitpunkt.

departure in der Antwort lesen

Ohne time-Parameter setzt der Dienst „jetzt” ein und schreibt den konkreten Zeitpunkt in die Antwort. Wenn Sie ein Ergebnis anzeigen oder zwischenspeichern, nehmen Sie diesen Wert — sonst behaupten Sie eine Erreichbarkeit, ohne zu sagen, wann sie gilt.

arriveBy

• false — „ich fahre um X los, wo bin ich in 30 Minuten?”
• true — „ich will um X da sein, von wo komme ich in 30 Minuten hin?”

Die beiden Richtungen liefern nicht dieselbe Menge. Fahrpläne sind nicht symmetrisch: Eine Haltestelle, von der man morgens wegkommt, muss abends nicht erreichbar sein.

Aus der Liste eine Fläche machen

Das Ergebnis sind Punkte, keine Fläche. Wer eine Erreichbarkeitskarte zeichnen will, muss selbst interpolieren — etwa über eine Voronoi-Zerlegung oder kleine Puffer um die Haltestellen.

Eine gezeichnete Fläche behauptet mehr, als die Daten hergeben

Zwischen zwei Haltestellen ist nichts an den ÖPNV angebunden. Eine flächige Darstellung suggeriert, man käme überall dazwischen hin; tatsächlich gilt die Aussage nur an den Haltestellen plus dem Fußweg drumherum. Wenn Sie flächig zeichnen, sagen Sie in der Legende dazu, was gemeint ist.

Größe der Antwort

Gemessen für 30 Minuten ab Klagenfurt Hbf: 233 kB. Die Antwort wächst deutlich mit maxTravelTime — in einem dichten Netz liefert eine Stunde ein Vielfaches. Fragen Sie nur den Zeitraum ab, den Sie wirklich darstellen.