GPS-Benchtracker Lohmar

Dieses Repository bündelt alle Node-RED- und Visualisierungskomponenten für den Use Case GPS-Benchtracker. Mobile Sitzbänke im Stadtgebiet sind mit GPS-Trackern ausgestattet, deren Positionsmeldungen über die MVV-Plattform bereitgestellt werden. Das Repository ermöglicht die automatisierte Anbindung dieser Daten, deren Überführung in standardisierte NGSI-LD Entitäten sowie die anschließende Auswertung und Darstellung des Standorts und des Bewegungsverlaufs der Bänke.

Die Anbindung besteht aus zwei eigenständigen Subflows. Der Subflow bench-gps-static-to-LD erzeugt aus den Stammdaten der API-Antwort eine Device-Entität mit Bezeichnung, Gerätekategorie, überwachter Eigenschaft und Anbieter; er wird typischerweise einmalig beziehungsweise selten ausgeführt. Der Subflow bench-gps-timeseries-to-LD wertet die Zeitreihen der Breiten- und Längengrade aus und erzeugt für jeden gemeldeten Zeitpunkt eine BenchTracking-Entität mit Geokoordinaten als GeoProperty vom Typ Point, dem Beobachtungszeitpunkt als dateObserved sowie einer Relationship auf die zugehörige Device-Entität. Fehlen die Zeitreihen für Breiten- oder Längengrad, wird eine Warnung protokolliert und keine Nachricht ausgegeben. Die Subflows führen ausschließlich die Datentransformation durch; Datenabruf und Übergabe an den Context Broker erfolgen im umgebenden Flow, sodass die Subflows unabhängig von einer konkreten Plattformanbindung wiederverwendbar sind.

Ergänzend enthält das Repository SQL-Views, die die in der Zeitreihen-Datenbank abgelegten Entitäten für die Auswertung aufbereiten. Sie lösen die NGSI-LD Payloads in flache Spalten auf, gewinnen den Beobachtungszeitpunkt aus der Entitäts-ID, reichern die Positionsmeldungen um die Stammdaten des zugehörigen Trackers an und verdichten sie wahlweise auf die jüngste Meldung je Tracker und Zehn-Minuten- beziehungsweise Stundenintervall. Eine weitere View bereitet die Stammdaten der Standorte auf. Hinzu kommt ein exportiertes Apache-Superset-Dashboard zur Visualisierung der Standorte der Sitzbänke auf einer Karte, mit Filtern nach Zeitraum und einzelnem Tracker. Views und Dashboards liegen als versionierbare Definitionsdateien vor und können in eine bestehende Datenbank- und Superset-Instanz importiert werden; der Dashboard-Export enthält bewusst nur Dashboard und Charts, da Datenbankverbindung und Dataset deployment-spezifisch sind.

Alle deployment-spezifischen Werte sind über Credential- und Umgebungsvariablen des umgebenden Flows konfigurierbar. Das Repository enthält weder produktive Zugangsdaten noch Kunden- oder Standortdaten.

Voraussetzungen für den Betrieb sind eine Node-RED-Instanz ab Version 3.0 sowie der Zugriff auf eine Zeitreihen-Datenbank zur Speicherung und Analyse der Daten. Für die Dashboards wird zusätzlich eine Apache-Superset-Instanz benötigt, für die angereicherte Fehlerprotokollierung das Modul node-red-udp-error-utils; ohne dieses Modul funktioniert die Datentransformation weiterhin, lediglich die Nodes zur Fehlerbehandlung bleiben unaufgelöst.