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 (Aare.guru GmbH / cstuder@existenz.ch)

Datenquellen

Datenquelle für die Aare-Messdaten: Bundesamt für Umwelt, Abteilung Hydrologie

Datenquelle für Wettermesswerte: MeteoSchweiz, SwissMetNet

Datenquelle für Wettervorhersagen (Ausser Aare-Temperatur-Prognose): Freundlich gesponsert von Meteotest

Messdaten werden ausgeliefert über die 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 beim Existenz.ch Data APIs Newsletter: (Gibt nicht viele Mails)

powered by TinyLetter

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

Sicherheit

Bitte konsultiere unsere Security-Policy um Sicherheitsprobleme zu melden.

(Generiert auf securitytxt.org.)