Existenz API: Erweitertes Archiv für BAFU Hydrologie- und MeteoSchweiz SwissMetNet-Daten

Den folgenden Text habe ich am 5. August 2023 an die API-Newsletter-Liste verschickt. Trag dich in den Newsletter ein um auf dem Laufenden zu bleiben.

Graph der Aare-Temperatur in Bern über die letzten 20 Jahre

Wir nutzen die Sommerpause um unser Datenarchiv zu erweitern: In der Langzeit-Datenbank der Existenz API sind jetzt tatsächlich auch ziemlich lange Datenreihen vorhanden. Z.B. Aare-Temperatur-Messwerte in Bern der letzten 20 Jahre.

Konkret haben wir:

Sie sind so vollständig wie möglich in einer InfluxDB abgelegt, die Zugangsdaten und Beispielqueries sind auf der api.existenz.ch#influx zu finden.

Leider leider gibt es nach wie vor bei Influx keinen bequemen Read-Only-Zugang zum wirklich coolen Datenexplorer. Ich würde diesen noch so gerne öffentlich machen. Deshalb ist das einzige was ich euch bieten kann der Screenshot oben sowie Instruktionen, mit welchen Flux-Queries man die Daten aus Grafana oder via API abfragen kann. Wenn ihr Unterstützung braucht, kontaktiert mich einfach.

Die Metadaten, inbesondere zum Aufschlüsseln der Location-Codes, sind dafür einer wunderbar öffentlichen Datasette zu finden: api-datasette.konzept.space.

Aare.guru API: Auftakt Saison 2022 – Expansion nach Olten

Gute Neuigkeiten: Wir erweitern auf 2022 unser Einflussbereich aus und nehmen Olten als neuen Ort in der Aare.guru-API auf. Dank der privaten Messstation von Tobias Oetiker (TemperAare, iOS & Android) können wir diese Lücke im Messnetz schliessen.

Die schlechte Nachricht: Jetzt gibt’s ein Lehrstück in defensivem Programmieren: Da die neues Messstation nur die Temperatur, aber nicht die Wassermenge misst, wird die API für Olten einige null-Werte liefern.

Und ihr müsst jetzt sicherstellen, dass eure Integrationen & Apps damit umgehen können. (Hint: Die offizielle Aare.guru-App tut’s nicht…)

Die Änderungen sind auf der TEST-Instanz (https://aareguru-test.existenz.ch) bereits implementiert. Auf der LIVE-Instanz (https://aareguru.existenz.ch) folgen sie am 1. April 2022.

Betroffene Keys, welche neu null sein können:

  • flow (Insbesondere auch im Key aarepast)
  • flow_text
  • flow_gefahrenstufe

Betroffene LIVE-URLs, ab April:

Test-URLs:

Zukünftige Expansionspläne: Solothurn und Aarau

Wir würden auch gerne Solothurn und Aarau in der App aufnehmen und suchen für die Installation einer kleinen Messstation (Winziges Kästchen mit LoRaWAN-Anbindung, autonome Stromversorgung) Standorte an der Aare dafür.

Hast du in Solothurn oder Aarau einen Kontakt für einen Ort, z.B. ein Bootshaus, Ruderclub, Schwimmclub, Angler, Yachthafen, ARA-Ausfluss, Steg etc.? Melde den bitte bei mir (cstuder@existenz.ch).

P.S.: Das Techstack-Webinar vom letzten November ist hier online.

Video: Aare Guru Techstack Webinar

Oder direkt auf Vimeo: https://vimeo.com/652964623

Links & Zeugs

Umsysteme

Bilderquellen

Das dritte Jahrhunderthochwasser innerhalb 25 Jahren

Screenshot Aare.guru bei Hochwasser

Als ich vor zwei Jahren die offiziellen Gefahrenstufen für Hochwasser des BAFUs im Aare.guru integriert habe, glaubte ich nicht ernsthaft daran, dass diese Stufe je erreicht wird. Unser iOS-Programmierer offenbar auch nicht.

Ich habe mich geirrt: Am 16. Juli 2021 war es wieder soweit. Nach 1999 und 2005 das dritte Jahrhunderhochwasser innerhalb 25 Jahren.

Abfluss der Aare, Messstation Schönau Bern, Juni – Juli 2021, Quelle: BAFU

Die empfohlene maximale Abflussmenge für den Aareschwumm beträgt 250 m³/s. Nachdem die Aare Anfangs Juni diese Wassermenge erreicht hat, kam sie nur kurz Anfangs Juli unter den Schwellenwert, um danach sprunghaft auf die Rekordmenge anzusteigen. Die starken Niederschläge in der gesamten Schweiz über diese zwei Monate verunmöglichten bis Anfangs August jeglichen Wassersport.

Hoffen wir, dass dieser Sommer ein Ausnahmesommer bleiben wird. Optimistisch gestimmt bin ich diesbezüglich nicht mehr.

Spontane Saisoneröffnung 2021

Aare-Temperatur 11.6° C

Glücklicherweise hatte ich vor einer Geburtstagsparty im Eichholz schon mein Sommergepäck gepackt: Immer dabei ist ein wasserdichter Beutel mit Badehose.

Und so habe ich heute Nachmittag spontan meine persönliche Badesaison 2021 eröffnet. Allerdings kam ich bei 11° nicht weit, es ging mehr ums Prinzip als ums Baden.

Übrigens: Wir vom Aare.guru-Team haben einen neuen Onlineshop eröffnet und wunderschöne Badesäcke bedrucken lassen. Ein tolles neues Badetuch folgt auch bald.

Aare.guru- & Existenz-API Newsletter Auftakt 2021

Den folgenden Text habe ich am 6. April 2021 an die API-Newsletter-Liste verschickt. Trag dich in den Newsletter ein um auf dem Laufenden zu bleiben.

Christian

Eine kurzfristige Ansage: Aufgrund einer Änderung an der Datenlieferung der Wasserwerte musste ich das sorgfältig entwickelte Refactoring der Existenz-API ohne weiteres Testen deployen. Es sind keine grossen Änderungen passiert, aber vielleicht habe ich etwas übersehen.

Keine Änderung an der bestehenden Aare.guru-API. Ein neuer Endpoint: widget

Minimale Änderungen an den Metadaten (Stations- und Parameterliste) der Existenz-API: Die details-Felder sind umgestellt und etwas ausführlicher.

Was gibt’s sonst noch Neues?

  • Die APIs sind intern poliert und auf den neuesten Stand gebracht: Bessere Testabdeckung, schnellere Deployments, zentralisierteres Logging, neues Hintergrundbild für die Doku. Wir sind damit etwa auf Faktor 327 von 12.
  • Eine experimentelle InfluxDB-Datenbank steht zum Ausprobieren zur Verfügung. Die Credentials für die Verbindung sind auf api.existenz.ch dokumentiert. Es gilt Bring-Your-Own-Visualization. Ich hoffe im Verlauf des Sommers das ganze Datenarchiv der letzten Jahre dort hinaufzuladen.
  • Alle Metadaten zu den SwissMetNet- und Hydrologie-Zeitreihen sind jetzt als nifty Datasette verfügbar: api-datasette.konzept.space. Das ersetzt meine handgestrickte Karte.

Zu guter Letzt bin ich stolz mein Lockdown-Projekt zu präsentieren: Das AareDisplay.

Und jetzt heisst es warten bis der Schnee zusammen mit den Viren endgültig definitiv verschwindet, die Wassertemperaturen steigen und wir hoffentlich einen gemütlichen Sommer geniessen dürfen.

Aare.guru- & Existenz-API Newsletter 2020

Den folgenden Text habe ich am 15. Oktober 2020 an die API-Newsletter-Liste verschickt. Trag dich in den Newsletter ein um auf dem Laufenden zu bleiben.

Christian

Eine denkwürdige Badesaison ist zu Ende gegangen: Bis spät in den September war die Aare für Normalsterbliche bebadbar. Neue Wörter in unserem Wortschatz. Das Virus brauchen wir gar nicht erst zu erwähnen. 

Was wir diesen Sommer getan haben

  • Wir hatten keine grösseren Ausfälle zu verzeichnen, die APIs liefen stabil. Im Hochsommer gibt es jeweils knapp 5 Millionen Zugriffe pro Monat, selbst im Oktober kommen täglich noch um die 50’000 Requests rein.
  • Die Dokumentationen sind hübscher geworden. Und mit OpenAPI/Swagger-Definitionen auch praktischer:

https://aareguru.existenz.ch & https://api.existenz.ch

  • Für Integrationen in IoT-Dings und Wearables und anderen Geräten mit wenig Rechenpower gibt es beim Aare.guru neu einen values-Parameter welcher ausgewählte Werte als Text zurück liefert. Nachwievor ist die API auch per HTTP erreichbar.
  • Neue Daten in der Aare.guru-API: Koordinaten der Messstationen sowie den Temperatur-Text im Kurzformat (text_short / temperature_text_short, weniger als 15 Zeichen).
  • Aare.guru-API-Responses werden standardmässig mit einer Cachezeit von 120 Sekunden zurückgegeben. Vielleicht stillt das etwas den Datenhunger einiger Integrationen. 

Was wir im Winter so treiben

  • Auf der Existenz-API ist jeweils nur ein Teil der historischen Daten verfügbar (30-90 Tage), das wird wahrscheinlich so bleiben. Allerdings möchte ich unser gesamtes Datenarchiv öffentlich anbieten, voraussichtlich in einer InfluxDB, sobald deren Version 2 released ist. Dann wird’s dann auch ein Grafana zum drin Rumspielen geben.

Soll es schneller gehen? Unterstütz uns mit dem Konsumieren von Konsumgütern in unserem Konsum.

Aare.guru in der macOS-Menubar

Screenshot der Menubar

Aare.guru überall!

Für die Browser Firefox und Google Chrome habe ich bereits Browser-Plugins geschrieben, welche dir die aktuelle Aare-Temperatur jederzeit auf den Desktop holen. Für Safari ist die Sache leider komplizierter und nicht so einfach möglich.

Dafür gibt es ab sofort für macOS das offizielle Aare.guru-Bitbar-Plugin, welches bei dir in der Menuzeile residiert.

Guten Schwumm!

Aare-Temperatur im Home Assistant

Auf der Suche nach einer einfachen Möglichkeit die Zimmertemperatur für spätere Analysen über längere Zeit aufzuzeichnen, bin ich nach einigen Umwegen auf das fantastische Heimautomatisierung-Projekt Home Assistant gestossen.

Ich befinde mich noch in der Einarbeitungszeit, aber das Wichtigste zuerst: Die aktuelle Aare-Temperatur als Sensor.

sensor:
  - platform: rest
    name: Aare
    resource: http://aare.schwumm.ch/aare.json
    unit_of_measurement: "°C"
    value_template: '{{ value_json.temperature }}'

Als Icon schlage ich mdi:waves vor.