Vorhersage

Übersicht

Die Vorhersage-API liefert aktuelle Bedingungen, minütlichen Niederschlag, stündliche und tägliche Vorhersagen sowie Wetterwarnungen für eine gegebene Koordinate.

Endpoint

GET /forecast/{lat},{lon}

Parameter

Parameter	Erforderlich	Standard	Beschreibung
lat,lon	Ja	—	Breiten- und Längengrad als Pfadparameter (z.B. 47.37,8.55)
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
extend	Nein	—	Auf hourly setzen, um die stündliche Vorhersage über 48 Stunden hinaus zu verlängern
exclude	Nein	—	Kommagetrennte Blöcke zum Ausschließen: currently, minutely, hourly, daily, alerts

Beispielanfrage

GET /forecast/47.37,8.55?units=si

Beispielantwort

{
  "latitude": 47.37,
  "longitude": 8.55,
  "timezone": "Europe/Zurich",
  "offset": 1,
  "elevation": 408,
  "currently": {
    "time": 1709132400,
    "summary": "Partly Cloudy",
    "icon": "01d",
    "is_day": true,
    "temperature": 8.2,
    "apparentTemperature": 5.1,
    "humidity": 0.65,
    "pressure": 1018.5,
    "windSpeed": 12.3,
    "windDirection": 230,
    "cloudCover": 0.45,
    "visibility": 16.1
  },
  "hourly": {
    "summary": "Partly cloudy throughout the day.",
    "icon": "01d",
    "data": [
      {
        "time": 1709132400,
        "summary": "Partly Cloudy",
        "icon": "01d",
        "is_day": true,
        "temperature": 8.2,
        "apparentTemperature": 5.1,
        "humidity": 0.65,
        "pressure": 1018.5,
        "windSpeed": 12.3,
        "windDirection": 230,
        "cloudCover": 0.45,
        "precipitation": 0,
        "precipitationType": "none"
      }
    ]
  },
  "daily": {
    "summary": "Partly cloudy for the week.",
    "icon": "01d",
    "data": [
      {
        "time": 1709082000,
        "summary": "Partly cloudy throughout the day.",
        "icon": "01d",
        "is_day": true,
        "temperatureHigh": 11.5,
        "temperatureLow": 3.2,
        "humidity": 0.62,
        "pressure": 1018.5,
        "windSpeed": 15.1,
        "windDirection": 240,
        "cloudCover": 0.4,
        "precipitation": 0,
        "sunriseTime": 1709101200,
        "sunsetTime": 1709139600,
        "moonPhase": 0.62
      }
    ]
  },
  "alerts": []
}

Antwortblöcke

currently

Aktuelle Wetterbedingungen am angefragten Standort.

Feld	Typ	Beschreibung
time	integer	Unix-Zeitstempel
summary	string	Menschenlesbare Zusammenfassung
icon	string	Wetterbedingungscode mit Tag-/Nacht-Suffix (z.B. "01d", "07n"). Siehe Wettersymbole.
is_day	boolean	Ob der Datenpunkt in die Tageslichtstunden fällt
temperature	float	Temperatur
apparentTemperature	float	Gefühlte Temperatur
humidity	float	Relative Luftfeuchtigkeit (0–1)
pressure	float	Luftdruck auf Meeresniveau (hPa)
windSpeed	float	Windgeschwindigkeit
windDirection	integer	Windrichtung (0–360°)
cloudCover	float	Bewölkung (0–1)
visibility	float	Sichtweite

hourly

Stündliche Vorhersage für die nächsten 48 Stunden (oder verlängert mit extend=hourly). Jedes Element in data enthält dieselben Felder wie currently.

daily

Tägliche Vorhersage für die nächsten 7 Tage. Jedes Element in data enthält:

Feld	Typ	Beschreibung
time	integer	Unix-Zeitstempel (Tagesbeginn)
summary	string	Menschenlesbare Tageszusammenfassung
temperatureHigh	float	Tageshöchsttemperatur
temperatureLow	float	Nächtliche Tiefsttemperatur
sunriseTime	integer	Unix-Zeitstempel des Sonnenaufgangs
sunsetTime	integer	Unix-Zeitstempel des Sonnenuntergangs
moonPhase	float	Mondphase (0 = Neumond, 0.5 = Vollmond)
precipitation	float	Tägliche Niederschlagsmenge

alerts

Array aktiver Wetterwarnungen für das Gebiet. Jede Warnung enthält title, description, time, expires und severity.

Einheiten

Messgröße	us	si	ca	uk
Temperatur	°F	°C	°C	°C
Windgeschwindigkeit	mph	m/s	km/h	mph
Niederschlag	in/hr	mm/hr	mm/hr	mm/hr
Sichtweite	mi	km	km	mi
Höhenlage	ft	m	m	m

Fehler

Status	Beschreibung
400	Ungültige Koordinaten oder Parameter
403	Ungültiger API-Schlüssel
429	Ratenlimit überschritten
503	Vorhersagedaten nicht geladen