Aare.guru API
Dienschte hinger Aare.guru.
OpenAPI-Dokumentation öffnen Beispiel-Request
Diese API ist öffentlich und darf für nicht-kommerzielle Zwecke frei benutzt werden. Sag uns bitte auf aaregurus@existenz.ch Bescheid wenn du das machst. Und setz einen Link zurück auf Aare.guru sowie auf das BAFU. Danke.
Bei Requests auf die API bitte frei wählbare app und
version mitgeben. Z.B.:
...v2018/current?app=app.identifier.meine.app&version=1.42.
Die Erläuterung der Parameter innerhalb des Services findest du auf der in der Parameter-Liste weiter unten.
Mit viel Liebe, Christian Studer (cstuder@existenz.ch / Aare.guru GmbH)
Datenquellen
Aare-Messdaten schweizweit: Bundesamt für Umwelt, Abteilung Hydrologie
Aare-Messdaten Olten: TemperAare App (Android / iOS) von Tobias Oetiker.
Wettermesswerte: MeteoSchweiz, SwissMetNet
Wettervorhersagen (Ausser Aare-Temperatur-Prognose): Freundlich gesponsert von Meteotest, Bern
Mehr historische Daten? Messreihen werden ausgeliefert über die hauseigene Existenz.ch APIs.
Magst du freie Daten? Mach mit bei Opendata.ch, der Schweizer Sektion der Open Knowledge Foundation.
Status
Auf status.existenz.ch findest du die API-Statusinformationen.
Newsletter
Schreib dich ein bei den Existenz.ch & Aare.guru API News. (Gibt nicht viele Mails, versprochen.)
Alternativ siehst du auch alle News auf dem Hymnos-Blog unter dem Schlagwort Newsletter (RSS-Feed).
Tipps für Integrationen
Internet of Awesome Things!
- Die API ist auch unverschlüsselt über HTTP erreichbar.
-
Einzelne Werte können mit dem Parameter
valuesals Text extrahiert werden. Zum Beispiel:...&values=aare.temperature,aare.temperature_text - Die Messdaten kommen leicht verzögert (10-20 Minuten) rein und werden alle 10 Minuten aktualisiert.
- Es hat sich bewährt bei Integrationen ein Updateintervall von 5 Minuten zu verwenden.
- Cache-Dauer ist standardmässig 2 Minuten.
-
CORS-Header auf
*gesetzt. JSONP erlaubt via callback-Parameter. - Jeder Wert könnte jederzeit
nullsein, defensives Programmieren lohnt sich immer.
Parameter
Hier sind die meisten Parameter in den API-Responses erklärt. Bei Fragen: Einfach fragen.
| Name | Einheit | Beschreibung |
|---|---|---|
city |
Unique key für diesen Ort. | |
name |
Name der Messstation | |
longname |
Ausführlicher Name der Messstation | |
aare / temperature |
°C | Aktuelle Aaretemperatur, speziell™ gerundet auf eine Nachkommastelle |
aare_prec / temperature_prec |
°C | Aktuelle Aaretemperatur, ungerundet präzis. (Hinweis: Ab April 2021 garantiert das BAFU die Lieferungen mit den Nachkommastellen nicht mehr, kann jederzeit ausfallen.) |
historical_temp_max |
°C | Historische Maximaltemperatur inkl. Timestamp falls vorhanden. Von Hand eingetragen, deshalb evt. nicht immer sofort korrekt. |
sy / symt |
# | Wettervorhersage als Symbol |
syt |
Texterklärung des Wettersymboles | |
tt |
°C | Aktuelle Temperatur Luft |
tn |
°C | Tagesminimaltemperatur Luft |
tx |
°C | Tagesmaximaltemperatur Luft |
forecast |
true/false |
Aaretemperaturvorhersageexistenzflag (Aktuell immer
false)
|
time |
s | Zeitstempel in Sekunden seit 1.1.1970 |
url |
URL zum Datenservice HATEOAS! | |
today |
URL zum Today-Dienst HATEOAS! | |
text / temperature_text |
Aktueller Aaretemperaturspruch | |
text_short / temperature_text_short |
Kurzversion (Unter 15 Zeichen) des aktuellen Aaretemperaturspruch, z.B. für komplizierte Uhren | |
flow |
m³/s | Aktuelle Abflussmenge |
flow_text |
Abflussmenge als Text | |
flow_gefahrenstufe |
[1-5] | Aktuelle Gefahrenstufe an diesem Ort wie vom BAFU definiert. 1 ist gefahrenlos, ab 2 wird es gefährlich. |
forecast2h |
°C | Temperaturvorhersage in zwei Stunden |
height |
m ü. M. | Wasserhöhe absolut |
rr |
mm/10min | Regenmenge, aufgerundet auf Ganzzahlen |
rrreal |
mm/10min | Regenmenge, in Zehnteln |
rrisk |
% | Regenrisiko |
v |
Zeitperiode Vormittag | |
n |
Zeitperiode Nachmittag | |
a |
Zeitperiode Abend | |
suntotal |
stunden:minuten | Totale zu erwartende Sonnenmenge |
suntotalrelative |
% | Anteil zu erwartende Sonnenmenge am theoretischen Maximum |
ss |
min | Sonnenscheindauer |
sun_locations |
Sonnenaufgang und Untergangszeiten | |
position |
[0,1] | Fortschritt des Sonnenstandes |
coordinates |
[°N / °E] | Koordinaten der BAFU-Messstation |
Technologie
Bei Hobbyprojekten ist langweilige Technologie eine gute Idee. Hier laufen PHP und Textdateien.
Mehr Details gibt's im Aare Guru Techstack Webinar vom Dezember 2021.
Sicherheit
Bitte konsultiere unsere Security-Policy um Sicherheitsprobleme zu melden.
(Generiert auf securitytxt.org.)