Aare.guru Logo

Aare.guru API

Dienschte hinger Aare.guru.

OpenAPI-Dokumentation öffnen Beispiel-Request

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.

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.

Die Erläuterung der Parameter innerhalb des Services findest du auf der in der Parameter-Liste weiter unten.

JSONP erlaubt via callback-Parameter. CORS-Header auf * gesetzt. Cache-Dauer ist standardmässig 2 Minuten.

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

Messdaten 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!

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 Lieferunge 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
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.)