STA-Applikation - Anwenderdokumentation
FROST-Server
Beschreibung
Es wird ein Sensor Things API server (API-Version 1.1) basierend auf dem FROST-Server (https://github.com/FraunhoferIOSB/FROST-Server) Version 2.3.2 eingesetzt.
Zugriff über HTTP
Die API des FROST-Servers ist unter https://sta.niedersachsen.de/v1.1 erreichbar. Lesende Zugriffe sind ohne Anmeldung möglich.
STA Endpoints
https://sta.niedersachsen.de/v1.1/Datastreams
https://sta.niedersachsen.de/v1.1/MultiDatastreams (wird auf der Startseite nicht angezeigt)
https://sta.niedersachsen.de/v1.1/FeaturesOfInterest
https://sta.niedersachsen.de/v1.1/HistoricalLocations
https://sta.niedersachsen.de/v1.1/Locations
https://sta.niedersachsen.de/v1.1/Observations
https://sta.niedersachsen.de/v1.1/ObservedProperties
Zugriff über MQTT
Mit Message Queuing Telemetry Transport (MQTT) ist auch das Abonnieren von „Topics“ möglich. Hierzu ist beim lesenden Zugriff über HTTP keine Authentifizierung notwendig.
Der MQTT-Server ist zu erreichen unter mqtt://sta.niedersachsen.de:1883
Beispiel eines Topics (‚Alle neuen Wasserstandmeldungen der Station Bramsche‘): „v1.1/Datastreams(362)/Observations“
Messnetze
Daten der Luftüberwachung Niedersachsen (LÜN)
Beschreibung
Aktualisierungszyklus
Der Import der LÜN-Daten basiert auf den Datenquellen
- https://numis.niedersachsen.de/data/luen.json
48 Stunden Daten, nicht verifiziert. Der Import erfolgt stündlich um xx:45.
- https://numis.niedersachsen.de/data/luen30.json
30 Tage Daten, verifiziert. Der Import erfolgt wöchentlich, sonntags 03:50.
Die Daten werden gelesen und per HTTP in den FROST-Server übertragen.
Liste der Messwerte
Beispiel-Anfragen
Selektion einer Station: https://sta.niedersachsen.de/v1.1/Things?$filter=name+eq+%27luen_HRSW%27
Alle Messwerte der Station Hannover, PM1024, Hintergrund: https://sta.niedersachsen.de/v1.1/Observations?$filter=Datastream/name%20eq%20%27luen_HRSW/PM1024%27
Alle Messwerte der Station Hannover, PM1024, Hintergrund, alle Werte seit 2024-11-23T12:00:00Z: https://sta.niedersachsen.de/v1.1/Observations?$filter=Datastream/name%20eq%20%27luen_HRSW/PM1024%27%20and%20phenomenonTime%20gt%202024-11-23T12:00:00Z
Alle Messwerte der Station Hannover, PM1024, Hintergrund, letzte 3 Tage: https://sta.niedersachsen.de/v1.1/Observations?$filter=Datastream/name%20eq%20%27luen_HRSW/PM1024%27%20and%20phenomenonTime%20gt%20now()%20sub%20duration%27P1D%27%20mul%203
NLWKN-PegelOnline
Beschreibung
Aktualisierungszyklus
Der Import der NLWKN Daten basiert auf dem Webservice:
Über diese URL werden alle Stationen und deren zugehörigen (Mess-) Parametern entnommen.
Anhand den Stationen und den zugehörigen Parametern wird der Webservice erneut angefragt um die Messdaten für die Station-Parameter-Kombinaton zu erhalten.
Der Import eines Tages erfolgt stündlich, um xx:15h. Der Import von 30 Tagen erfolgt wöchentlich, samstags um 3:50h.
Liste der Messwerte
Beispiel-Anfragen
Abfrage der Station („Thing“) „pegel_ni_208“: https://sta.niedersachsen.de/v1.1/Things?$filter=name%20eq%20%27pegel_ni_208%27
Alle Wasserstandsmeldungen (Datastream: „nlwkn_208/nlwkn_1/nlwkn_12770469“) der Station „pegel_ni_208“: https://sta.niedersachsen.de/v1.1/Observations?$skip=2500&$filter=(Datastream%2Fname+eq+%27pegel_ni_208%2F1%2F12770469%27)
Alle Wasserstandsmeldungen der Station „nlwkn_208“ der letzten 7 Tage: https://sta.niedersachsen.de/v1.1/Observations?$filter=Datastream/name%20eq%20%27pegel_ni_208/1/12770469%27%20and%20phenomenonTime%20gt%20now()%20sub%20duration%27P1D%27%20mul%207
Grundwasser Niedersachsen
Der Import der Grundwasserdaten Niedersachsen basiert auf dem Webservice:
Über diese URL werden alle Stationen abgefragt.
Mit Hilfe dieser Stationen wird der Webservice erneut angefragt um die Messdaten für die einzelnen Stationen zu erhalten.
Der Import erfolgt täglich, um 6:30h.
Beispiel-Anfragen
Abfrage aller „Grundwasser-Things“: https://sta.niedersachsen.de/v1.1/Things?$filter=startswith(name,%27gw_%27)
Abfrage aller „Grundwasser-Datastreams“: https://sta.niedersachsen.de/v1.1/Datastreams?$filter=startswith(name,%27gw_%27)
Abfrage aller Messwerte einer Station der letzten 4 Tage: https://sta.niedersachsen.de/v1.1/Observations?$filter=Datastream/name%20eq%20%27gw_14880010_Grundwasser_P1D_MEAN%27%20and%20phenomenonTime%20gt%20now()%20sub%20duration%27P1D%27%20mul%204
Ortsdosisleistung des Bundesamts für Strahlenschutz (ODL)
Beschreibung
Aktualisierungszyklus
Der Import der ODL-Daten basiert auf dem Webservice https://www.imis.bfs.de/ogc/opendata/ows?service=WFS&version=1.1.0&request=GetFeature&typeName=opendata:odlinfo_odl_1h_latest&outputFormat=application/json
Über diese URL werden alle Daten zu den Stationen entnommen.
Anhand der Stationen wird der Webservice erneut angefragt, um die Messwerte zu erhalten.
Hierbei wird folgende URL als Template verwendet:
- {station_id}
eindeutige Messstellenkennung
Der Import der ODL-Daten erfolgt stündlich um xx:00.
Die Daten werden gelesen und per HTTP in den FROST-Server übertragen.
Liste der Messwerte
Beispiel-Anfragen
Abfrage aller „ODL-Things“: https://sta.niedersachsen.de/v1.1/Things?$filter=startswith(name,%27odl_%27)
Abfrage aller „ODL-Datastreams“: https://sta.niedersachsen.de/v1.1/Datastreams?$filter=startswith(name,%27Gamma-ODL-Brutto/%27)
Abfrage aller Messwerte einer Station der letzten 4 Tage: https://sta.niedersachsen.de/v1.1/Observations?$filter=Datastream/name%20eq%20%27Gamma-ODL-Brutto/DEZ2715%27%20and%20phenomenonTime%20gt%20now()%20sub%20duration%27P1D%27%20mul%204
Luftqualitätsindex (LQI) des Umweltbundesamtes (ODL)
Beschreibung
Der Luftqualitätsindex ist ein Indikator für die Luftqualität. Das Umweltbundesamt ermittelt diesen aus den gemessenen Konzentrationen verschiedener Schadstoffe (Stickstoffdioxid, Feinstaub (PM₁₀ und PM₂,₅) und Ozon), wobei die gesundheitlich kritischste der gemessenen Konzentrationen das Gesamtergebnis bestimmt.
Aktualisierungszyklus
Der LQI und die zugehörigen Schadstoffwerte werden stündlich aktualisiert.
Liste der Messwerte
Der Luftqualitätsindex (LQI)
Weiterhin die Konzentrationen der Schadstoffe aus denen der LQI bestimmt wird (soweit sie an der jeweiligen Station ermittelt werden):
Stickstoffdioxid (NO₂)
Feinstaub (PM₁₀)
Ozon (O₃)
Feinstaub (PM₂,₅)
Beispiel-Anfragen
Abfrage aller „UBA-Things“ für den LQI: https://sta.niedersachsen.de/v1.1/Things?$filter=startswith(name,%27uba_%27)
Abfrage aller LQI-Datastreams für Ozon für alle Things im Land Brandenburg : https://sta.niedersachsen.de/v1.1/Datastreams?$filter=startswith(name,%27uba_BB_%27)%20and%20endswith(name,%20%27_LQI_O3%27)
Abfrage der NO₂-Messwerte der Station Potsdam-Babelsberg der letzten 5 Tage (Station DEBB073, Datastream: uba_BB_DEBB073_LQI_NO2): https://sta.niedersachsen.de/v1.1/Observations?$filter=Datastream/name%20eq%20%27uba_BB_DEBB073_LQI_NO2%27%20and%20phenomenonTime%20gt%20now()%20sub%20duration%27P1D%27%20mul%205
Abfrage des LQI (kodiert als Integer-Wert) der Station Potsdam-Babelsberg am 15.01.2025, 13:00 MEZ (12:00 UTC) (Station DEBB073, Datastream: uba_BB_DEBB073_LQI): https://sta.niedersachsen.de/v1.1/Observations?$filter=Datastream/name%20eq%20%27uba_BB_DEBB073_LQI%27%20and%20phenomenonTime%20eq%202025-01-15T12:00:00Z