Historisches Wetter
Historische Wetterdaten für jeden Standort und jedes Datum abrufen.
Übersicht
Die API für historisches Wetter liefert tägliche Wetterdaten für ein bestimmtes Datum und einen bestimmten Standort.
Endpoint
GET /historical/{lat},{lon},{timestamp}Parameter
| Parameter | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
lat,lon,timestamp |
Ja | — | Breiten-, Längengrad und Zeitstempel als Pfadparameter |
units |
Nein | us |
Einheitensystem: us (imperial), si (metrisch), ca (metrisch mit km/h Wind), uk (metrisch mit mph Wind), auto (basierend auf dem Land) |
lang |
Nein | en |
Sprachcode für Textzusammenfassungen |
Der Zeitstempel akzeptiert mehrere Formate:
- Unix-Zeitstempel:
1455537600 - ISO 8601 mit Z:
2016-02-15T12:00:00Z - ISO 8601 mit Offset:
2016-02-15T12:00:00+00:00 - ISO 8601 ohne Zeitzone (wird als UTC interpretiert):
2016-02-15T12:00:00
Beispielanfrage
GET /historical/47.37,8.55,2025-06-15T12:00:00Z?units=siBeispielantwort
{
"latitude": 47.37,
"longitude": 8.55,
"timezone": "Europe/Zurich",
"offset": 2,
"daily": {
"summary": "Partly cloudy throughout the day.",
"icon": "01d",
"data": [
{
"time": 1750003200,
"summary": "Partly Cloudy",
"icon": "01d",
"is_day": true,
"temperatureHigh": 24.5,
"temperatureLow": 14.2,
"temperatureAvg": 19.3,
"windSpeed": 8.5,
"windDirection": 210,
"humidity": 0.58,
"pressure": 1015.2,
"visibility": 24.1,
"cloudCover": 0.35,
"precipitation": 0,
"sunriseTime": 1749956400,
"sunsetTime": 1750013400,
"moonPhase": 0.72
}
]
}
}Tägliche Datenfelder
| Feld | Typ | Beschreibung |
|---|---|---|
time |
integer | Unix-Zeitstempel (Tagesbeginn) |
summary |
string | Menschenlesbare Wetterzusammenfassung |
icon |
string | Wetterbedingungscode mit Tag-/Nacht-Suffix (z.B. "01d", "07n"). Siehe Wettersymbole. |
is_day |
boolean | Ob der Datenpunkt in die Tageslichtstunden fällt |
temperatureHigh |
float | Tageshöchsttemperatur |
temperatureLow |
float | Nächtliche Tiefsttemperatur |
temperatureAvg |
float | Durchschnittstemperatur des Tages |
windSpeed |
float | Durchschnittliche Windgeschwindigkeit |
windDirection |
integer | Vorherrschende Windrichtung (0–360°) |
humidity |
float | Durchschnittliche relative Luftfeuchtigkeit (0–1) |
pressure |
float | Luftdruck auf Meeresniveau (hPa) |
visibility |
float | Sichtweite |
cloudCover |
float | Bewölkungsgrad (0–1) |
precipitation |
float | Gesamtniederschlag |
precipitationType |
string | Art des Niederschlags (falls zutreffend) |
sunriseTime |
integer | Unix-Zeitstempel des Sonnenaufgangs |
sunsetTime |
integer | Unix-Zeitstempel des Sonnenuntergangs |
moonPhase |
float | Mondphase (0 = Neumond, 0.5 = Vollmond) |
Fehler
| Status | Beschreibung |
|---|---|
400 |
Ungültiges Standortformat, Koordinaten außerhalb des Bereichs oder zukünftiger Zeitstempel |
403 |
Ungültiger API-Schlüssel |
429 |
Ratenlimit überschritten |
503 |
Historische Daten nicht geladen |
