Integration in Fahrgastinformations-Systeme

Inhaltsverzeichnis

Daten abfragen aus FGI-App-Perspektive

Die folgenden Flussdiagramme zeigen, wie Stammdaten und Echtzeitdaten über Aufzüge ins FGI-Backend gelangen. Aufgrund des niedrigen Datenvolumens und für einfaches Debugging ist die Architektur bewusst nicht Event-Queue-basiert, sondern basiert auf Polling, also regelmäßigem Abfragen der Daten über die API.


FahrgastFGI-AppFGI-Backendaccessibility.cloud Transit APIEigener CacheCache erneuern / aufwärmenRouting-AnfrageStammdatenEchtzeitdaten Stammdaten abfragenJSON-ResponseCache updateRealtime-Daten abfragenJSON-ResponseCache updateRouting-AnfrageAPI-RequestPrüfe CacheCache Hit/MissDaten abfragen (bei Miss)JSON-ResponseCache updateReisekette inkl. AufzugsstatusRoute anzeigen


Stammdaten abfragen

Stammdaten beschreiben die Beschaffenheit einer Anlage, nicht ihren Echtzeit-Betriebszustand. Die Stammdaten enthalten passende ID-Referenzen zu eigenen Datenbeständen. Sie können über die API abgefragt werden.

Enthaltene Stammdaten

Datentyp

Beschreibung

Organisationen

Namen, Kontakte

Stop Places

DHIDs, interne IDs, Betreiber-Verknüpfung

Aufzüge

Bezeichner (mehrsprachig, TTS), Betreiber-IDs, Barrierefreiheits-Informationen

GTFS Stops

stop_id, stop_name, location_type, parent_station

GTFS Pathways

Wegabschnitte zwischen Stops

NeTEx Equipment

LiftEquipment, EscalatorEquipment, etc.

Die Stammdaten werden in niedriger Frequenz (z.B. 2x täglich) zwischen Systemen synchronisiert.

FGI-App-Backendaccessibility.cloud Transit API GET /api/schema-organizations?depth=0JSON mit Organisations-DatenGET /api/stop-places?depth=0JSON mit Stop-Place-DatenGET /api/elevators?depth=0JSON mit Elevator-DatenStammdaten lokal zwischenspeichern

Echtzeit-Betriebszustände abfragen

Als Echtzeitdaten bezeichnen wir Daten, die den aktuellen Betriebszustand einer Anlage beschreiben. Diese werden in höherer Frequenz über die API synchronisiert.

Enthaltene Echtzeitdaten

Feld

Beschreibung

operational_status

in_service, out_of_service, partially_operational, unknown

status_spans

Zeitspannen mit Betriebszuständen

FGI-App-Backendaccessibility.cloud Transit API GET /api/elevators?select[operational_status][operational_status]=trueMinimale JSON-Antwort mit StatusdatenStatusdaten lokal zwischenspeichern

Caching-Empfehlungen

Wir empfehlen, Stamm- und Statusdaten im FGI-Backend zwischenzuspeichern.

Vorteile

  • Keine Abhängigkeit zur Transit-API bei Anfrage-Peaks
  • Höhere Fehlertoleranz
  • Geringerer Traffic und schnellere Antwortzeiten

Empfohlene Cache-Intervalle

Datentyp

Empfohlenes Cache-Intervall

Stammdaten (Aufzüge, Stop Places)

1-2 Stunden

Echtzeit-Status

1-2 Minuten