*************************************** 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 https://sta.niedersachsen.de/v1.1/Sensors https://sta.niedersachsen.de/v1.1/Things 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: https://bis.azure-api.net/PegelonlinePublic/REST/stammdaten/stationen/All?key=9dc05f4e3b4a43a9988d747825b39f43 Ü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: https://bis.azure-api.net/GrundwasserstandonlinePublic/REST/stammdaten/stationen/allegrundwasserstationen?key=9dc05f4e3b4a43a9988d747825b39f43 Ü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: https://www.imis.bfs.de/ogc/opendata/ows?service=WFS&version=1.1.0&request=GetFeature&typeName=opendata:odlinfo_timeseries_odl_1h&outputFormat=application/json&viewparams=kenn:{station_id} {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 `_ .. toctree:: :maxdepth: 2 :hidden: /index /technical_doc