Zur Abfrage der erfassten Messwerte aller Wetterstationen können Sie unsere
REST-konforme API nutzen. Alle Antworten werden
JSON-formatiert ausgegeben.
Die API kann sowohl für private als auch kommerzielle Nutzung kostenfrei angesprochen werden. Jedoch ist nur die Abfrage der Messwerte beliebig vieler eigener Stationen sowie bis zu 3 weiterer fremder Stationen erlaubt. Für darüber hinaus gehende Abfragen kontaktieren Sie uns bitte für ein individuelles Angebot.
Abfrage Informationen zur Wetterstation
http://api.openmeteo.com/observations/openmeteo/StationID
Der Platzhalter
StationID ist in diesem Fall durch die eindeutige Nummer der jeweiligen Wetterstation zu ersetzen.
Abfrage einzelner Sensor
Sämtliche Abfragen erfolgen per
HTTP-GET-Request. Abfragen die auf nicht existierende Wetterstationen und/oder Sensoren verweisen werden mit dem
HTTP-Statuscode 404 beantwortet.
Abfrage des letzten Messwertes
http://api.openmeteo.com/observations/openmeteo/StationID/SensortypeSensornummer
Die Nummerierung der Sensoren eines Types beginnt gewöhnlich mit der Zahl 0.
Die Ausgabe der Messwerte erfolgt in Form eines Arrays. Der erste Wert enthält immer die zugehörige Zeit im
Unixtime-Format. Die folgenden Werte sind abhängig vom Sensortype (siehe Tabelle). Eine Liste der jeweilig verfügbaren Sensoren finden Sie im Array 'sensors' in den Informationen zur Wetterstation.
| Sensortype |
Ausgabeformat |
Beispiel |
| t |
Temperatur in °C |
t2 |
| th |
Temperatur in °C, Luftfeuchte in % |
th0 |
| thb |
Temperatur in °C, Luftfeuchte in %, Luftdruck in hPa |
thb0 |
| baro |
Luftdruck in hPa |
baro0 |
| wind |
Richtung in Grad, Geschwindigkeit in m/s, Durchschnittsgeschwindigkeit in m/s |
wind0 |
| rain |
aktueller Niederschlag in mm/h, Niederschlag gestern in mm, Niederschlag gesamt in mm |
rain0 |
Zeitreihe - Abfrage der letzen Messwerte
http://api.openmeteo.com/observations/openmeteo/StationID/SensortypeSensornummer/lastZeitraumMaßeinheit
Die Ausgabe erfolgt als Messreihe in From eines zweidimensionlen Arrays. Gleichlange Zeiträume können unterschiedlich definiert werden, so entspricht z.B.
last3600s und
last1h jeweils einer Stunde.
Zeitreihen für Tag, Monat und Jahr
http://api.openmeteo.com/observations/openmeteo/StationID/SensortypeSensornummer/Datum
Die Ausgabe erfolgt als Messreihe in From eines zweidimensionlen Arrays.
| Datumsformat |
Bedeutung |
Beispiel |
|
| YYYYMMDD |
Abfrage aller Messwerte eines Tages, das Jahr muss 4stellig, Monat und Tag jeweils 2stellig angegbene werden |
wind0/20120220 |
| YYYYMM |
Abfrage aller Messwerte eines Monats, das Jahr muss 4stellig, der Monat 2stellig angegbene werden |
th0/201202 |
| YYYY |
Abfrage aller Messwerte eines Jahres, das Jahr muss 4stellig angegbene werden. Achtung! Die Ausgabe kann mehrere hundert Megabyte an Daten zurückliefern. |
th0/2012 |
Zeitreihen und Ausgabe von Durchschnitt, Minium und Maximum
http://api.openmeteo.com/observations/openmeteo/StationID/SensortypeSensornummer/[Datum] oder [lastZeitraumMaßeinheit]/avgIntervallMaßeinheit Intervall
Die Ausgabe erfolgt als Messreihe in From eines zweidimensionlen Arrays.
| Sensortype |
Ausgabeformat |
Beispiel |
| t |
Temperatur in °C (Durchschnitt, Minimum, Maximum), Anzahl der Messwerte |
t2/20120504/avg1h |
| th |
Temperatur in °C (Durchschnitt, Minimum, Maximum), Luftfeuchte in % (Durchschnitt, Minimum, Maximum), Anzahl der Messwerte |
th0/last24h/avg1h |
| thb |
Temperatur in °C (Durchschnitt, Minimum, Maximum), Luftfeuchte in % (Durchschnitt, Minimum, Maximum), Luftdruck in hPa (Durchschnitt, Minimum, Maximum), Anzahl der Messwerte |
thb0/201205/avg1d |
| wind |
Richtung in Grad (Durchschnitt, Richtung der höchsten gemessenen Geschwindigkeit, Verteilung der einzelnen Messwerte auf auf die 16 Windrichtung [N, NNO, NO, ONO, OSO, SO, SSO, S, SSW, SW, WSW, W, WNW, NW, NNW]), Geschwindigkeit in m/s (Durchschnitt, Minimum, Maximum), Anzahl der Messwerte |
wind1/20120504/avg15m |
| rain |
aktueller Niederschlag in mm/h, Niederschlag gestern in mm, Niederschlag gesamt in mm (noch nicht vollständig implementiert) |
rain0/201205/avg1d |
Übermittlung neuer Messwerte
Sämtliche Updates erfolgen per
HTTP-POST-Request. Der POST-Request muss sich per
HTTP Basic Authentication am Webserver authentifizieren. Der Nutzername entspricht der
StationID, dass Passwort können Sie in den Einstellungen Ihrer Wetterstation im Nutzerbereich ablesen. Alle Messwerte müssen wie bei der Abfrage als JSON-formatiertes Array übermittelt werden. Handelt es sich beim Update um einen akutellen Messwert (Übermittlung in Echtzeit), kann die Zeitangabe im Unixtime-Format weggelassen werden.
Die URL ist identisch der Abfrage des letzen Messwertes aufgebaut. Die einzelnen Sensortypen und erwarteten Parameter können Sie der
Tabelle im Abfrage Bereich entnehmen.
http://api.openmeteo.com/observations/openmeteo/StationID/SensortypeSensornummer
| HTTP Status Code |
Bedeutung |
| 200 OK |
neuer Messwert erfolgreich gespeichert |
| 400 Bad Request |
Anzahl der Elemente im Array entspricht nicht der erwarteten Anzahl für diesen Sensortyp |
| 401 Unauthorized |
Nutzername und Passwort nicht übermittelt |
| 403 Forbidden |
Nutzername und/oder Passwort falsch |
| 404 Not Found |
StationID oder Sensortype unbekannt |
| 410 Gone |
Sensor administrativ abgeschaltet |
| 415 Unsupported Media Type |
Messwerte nicht im JSON-Format |
