Wetter-API

Vorhersage#

Parameter

Antwort

{
  "latitude": 48.85,
  "longitude": 2.35,
  "timezone": "Europe/Paris",
  "grid": {
    "latitude": 48.85, "longitude": 2.35,
    "distance_km": 0.42, "resolution_km": 1.3
  },
  "elevation": {
    "applied": true,
    "model_elevation_m": 91.0,
    "location_elevation_m": 113,
    "temperature_offset_c": -0.14
  },
  "source": {
    "model": "mf_arome",
    "model_run": "20260801T00Z",
    "reference_time": "2026-08-01T00:00:00+00:00",
    "data_age_hours": 3.95,
    "stale": false,
    "attribution": "Data: Météo-France (etalab-2.0)"
  },
  "hourly": {
    "time": ["2026-08-01T00:00:00+02:00", "..."],
    "temperature_2m": [18.1, 17.9, 17.6, "..."],
    "apparent_temperature": [17.4, "..."],
    "weather_code": [0, 1, 2, "..."]
  },
  "daily": {
    "date": ["2026-08-01", "..."],
    "temperature_2m_max": [26.6, "..."],
    "temperature_2m_min": [16.2, "..."],
    "precipitation_sum": [0.0, "..."],
    "uv_index_max": [7.6, "..."],
    "sunrise": ["2026-08-01T06:24:00+02:00", "..."],
    "sunset": ["2026-08-01T21:24:00+02:00", "..."],
    "daylight_hours": [15.0, "..."]
  }
}

Die Nutzlast verkleinern

Der vollständige Stundenblock über 15 Tage umfasst rund 32 Felder × 360 Stunden. Wenn Sie drei davon darstellen, fragen Sie drei an:

GET /v1/forecast?lat=48.85&lon=2.35&days=3
    &hourly=temperature_2m,precipitation,weather_code
    &include_daily=false

Gleicher Preis — die Kosten entstehen beim Lesen des Archivs, nicht beim Serialisieren — aber ein Zehntel der Bytes und spürbar schneller zu parsen auf einem Telefon.

Vorhersage nach Stadt#

Ziehen Sie dies rohen Koordinaten vor, wo immer es geht. Der Katalog liefert zwei Dinge, die eine Koordinate nicht kann: die echte Höhe der Stadt, sodass die Geländekorrektur greift, ohne dass Sie sie angeben, und ihre Zeitzone, sodass die Tagesaggregate am richtigen lokalen Tag geschnitten werden.

GET /v1/forecast/city/dz/alger      # französischer Slug
GET /v1/forecast/city/dz/algiers    # englischer Slug — dieselbe Stadt
GET /v1/forecast/city/fr/paris

country ist ein ISO-3166-1-alpha-2-Code in Kleinbuchstaben. slug ist unabhängig von Akzenten: bejaia findet Béjaïa. Ein unbekannter Slug gibt 404 city_not_found mit einem suggestions-Array zurück — zeigen Sie es an statt einer Sackgasse.

Alle Query-Parameter von /v1/forecast gelten weiter, außer lat, lon und elevation, die der Katalog liefert. timezone zu übergeben überschreibt die der Stadt, was fast nie gewollt ist.

Aktuelle Bedingungen#

Temperatur, Luftfeuchte, Wind und Druck werden linear auf den aktuellen Zeitpunkt interpoliert, zwischen den beiden Modellschritten, die ihn einschließen.

Nutzen Sie das für eine „gerade jetzt“-Anzeige. Für alles, was Sie über die Zeit vergleichen, nehmen Sie /v1/forecast und lesen die gewünschte Stunde: die Reihe ist stabil, während jetzt Ihnen zwischen zwei Aufrufen unter den Füßen wegwandert.

Feldreferenz#

Stundenfelder

21 davon kommen standardmäßig zurück. Die übrigen gehören Ihnen, sobald Sie danach fragen — nennen Sie sie in hourly=, durch Kommas getrennt — und sie werden aus Kostengründen zurückgehalten, nicht aus Zweifel: jedes gespeicherte Feld ist ein eigener komprimierter Lesevorgang, sodass eine Standardantwort mit allen 45 jeden Aufrufer für die wenigen zahlen ließe, die die Schneehöhe wollen.

GET /v1/forecast?lat=45.19&lon=5.72&hourly=temperature_2m,snow_line_altitude,soil_temperature_8cm

Ein Feld, das ein Modell nicht veröffentlicht, kommt für den Abschnitt der Vorhersage dieses Modells als null zurück, statt aus der Antwort zu verschwinden — eine Kette, die auf AROME beginnt und auf ICON-EU weiterläuft, liefert also durchgehend visibility, für die ersten 51 Stunden null. Ein unbekannter Feldname ergibt ein 400 unknown_field mit der nächstliegenden Entsprechung als Vorschlag; früher wurde er stillschweigend ignoriert.

Tagesfelder

date, temperature_2m_max, temperature_2m_min, temperature_2m_mean, precipitation_sum, wind_speed_max, wind_gust_max, shortwave_radiation_sum (MJ/m²), uv_index_max, sunrise, sunset, daylight_hours, weather_code.

Aggregiert auf lokale Kalendertage, nicht UTC. Ein angebrochener Tag an einem Ende des Bereichs wird weggelassen statt mit einem irreführenden Maximum ausgewiesen — eine Anfrage über 7 Tage kann also berechtigterweise 6 Tageszeilen zurückgeben.

Modelle und Auflösung#

Wir liefern das feinste Modell aus, das Ihren Punkt und Ihre Vorlaufzeit abdeckt. Sie wählen nie eines aus; die Wahl wird in source.model ausgewiesen, sodass Sie immer erkennen können, welches geantwortet hat.

Hochauflösende Modelle sind allesamt kurzfristig — bei 1 km wird die Atmosphäre binnen zweier Tage chaotisch, weiter zu rechnen wäre also sinnlos — und die Auflösung sinkt daher stufenweise, je weiter die Vorhersage fortschreitet:

Tag 0 ─────── Tag 2 ─────── Tag 5 ───────────────── Tag 15
  AROME 1,3 km (Frankreich)
  ICON-D2 2,2 km (Deutschland, Alpen, Benelux)
  HRRR 3 km (USA und südliches Kanada)
              ICON-EU 6,5 km (Europa)
                          ICON 13 km · EZMW 28 km (global)
                                              AIFS (nur Trend)

Übergänge am Rand eines Modellgebiets werden übergeblendet, sodass zwei Orte beiderseits einer Grenze nie durch einen Sprung voneinander abweichen.

/v1/models braucht keinen Schlüssel, was es zum richtigen Endpunkt macht, um ihn von einer Statusseite abzufragen oder vor dem Kauf zu prüfen: er meldet den jüngsten Lauf jedes Modells und dessen Alter, sodass sich „sind die Daten frisch“ beantworten lässt, ohne einen Credit auszugeben.

Ensemble-Wahrscheinlichkeiten#

Eine einzelne Vorhersage sagt 22 °C am Donnerstag. Das ist eine Vermutung, die als Tatsache auftritt. Dieser Endpunkt beantwortet die Frage, nach der Sie tatsächlich entscheiden: wie sicher ist das, und mit welcher Regenwahrscheinlichkeit lohnt es sich zu planen.

Berechnet wird er aus dem Ensemble des EZMW — dasselbe Modell, 50-mal aus leicht verschiedenen Anfangsbedingungen gerechnet. Wo die Läufe übereinstimmen, ist die Vorhersage sicher. Wo sie streuen, ist die Atmosphäre selbst unsicher, und kein Modell, so gut es auch sei, kann Ihnen mehr sagen.

{
  "members": 50,
  "hourly": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "temperature_2m_p10": [26.4],
    "temperature_2m_p50": [26.78],
    "temperature_2m_p90": [27.3],
    "temperature_2m_spread": [0.4],
    "precipitation_probability_0_1mm": [10.0],
    "precipitation_probability_1_0mm": [0.0],
    "precipitation_probability_5_0mm": [0.0],
    "precipitation_probability_10_0mm": [0.0],
    "precipitation_p90": [0.1]
  }
}

Wie man es liest

p10 und p90 umschließen die mittleren 80 % der Mitglieder: eines von zehn erwartet es kälter als p10, eines von zehn wärmer als p90. Ein spread von 0,4 °C ist eine gefestigte Lage, der Sie trauen können; 3 °C heißt, dass die Modelle uneins sind und Sie das Ihren Nutzern lieber sagen sollten, als eines auszuwählen.

Die Regenschwellen sind Entscheidungen und keine runden Zahlen — 0,1 mm heißt überhaupt nass, 1 mm heißt nehmen Sie eine Jacke, 5 und 10 mm heißen das wird ein Problem. precipitation_p90 ist der ungünstige Fall: nur eines von zehn Mitgliedern ist nasser.

Luftqualität#

Das ist der Endpunkt, der in Nordafrika und im Mittelmeerraum am meisten zählt. Eine Staubepisode treibt PM10 tagelang über tausend Mikrogramm je Kubikmeter, was eher eine Gesundheitsentscheidung als eine Zahl ist, und wird von kostenlosen Verbraucherdiensten schlecht abgedeckt.

{
  "current": {
    "pm2_5": 38.7,
    "band": "poor",
    "who_guidelines_ug_m3": {"pm2_5": 15.0, "pm10": 45.0,
                             "nitrogen_dioxide": 25.0, "ozone": 100.0}
  },
  "hourly": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "pm2_5": [38.7], "pm10": [85.8], "ozone": [43.4],
    "nitrogen_dioxide": [19.0], "dust_aod_550nm": [0.24]
  },
  "units": {"pm2_5": "ug/m3", "pm10": "ug/m3", "dust_aod_550nm": "1"}
}

Alle Konzentrationen sind in µg/m³ angegeben, der Einheit, in der Luftqualität überall genannt wird. dust_aod_550nm ist eine optische Dicke und hat keine Einheit: oberhalb von etwa 0,5 ist der Himmel sichtbar trüb, oberhalb von 1,0 ist die Sonne gedämpft.

Die Kurzzeit-Richtwerte der WHO reisen in jeder Antwort mit, sodass sich eine Zahl einordnen lässt, ohne sie nachzuschlagen. band folgt dem europäischen Luftqualitätsindex für PM2,5: gut, ausreichend, mäßig, schlecht, sehr schlecht, äußerst schlecht.

Schnee und die Schneefallgrenze#

Vier Felder, und sie beantworten verschiedene Fragen. snowfall ist, wie viel fällt; die übrigen beschreiben, was am Boden liegt, und wo.

Fragen Sie sie namentlich an — sie stehen nicht in der Standardantwort:

GET /v1/forecast?lat=45.19&lon=5.72&hourly=snowfall,snow_depth,snow_water_equivalent,snow_line_altitude,freezing_level_altitude

Die Schneefallgrenze ist die, die zu lesen sich lohnt. „Auf 800 m regnet es und auf 1200 m schneit es“ ist eine Aussage, nach der ein Skigebiet, eine Straßenmeisterei oder ein Autofahrer handeln kann; „3 mm Niederschlag“ nicht. Sie zählt auch in Nordafrika — der Atlas hat Skigebiete in Chréa und Tikjda, und die Hochebenen von Sétif, Batna und Djelfa liegen über 1000 m.

Diese Felder stammen aus ICON des DWD, das die Welt mit 13 km abdeckt. Die offenen Daten des EZMW veröffentlichen die Schneehöhe, aber nicht die Schneefallgrenze: hier ist das gröbere Modell also das nützlichere. snow_line_altitude ist ein regionales Produkt — ICON-EU und ICON-D2 veröffentlichen es, ICON global nicht, außerhalb Europas bekommen Sie also die Isotherme und die Höhe, aber nicht die Grenze selbst.

See — Seegang#

{
  "hourly": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "wave_height": [0.32],
    "wave_direction": [264.3],
    "wave_period": [3.79],
    "wave_peak_period": [4.21]
  }
}

Die Wellenhöhe ist die signifikante Wellenhöhe — das Mittel des höchsten Drittels der Wellen, was in etwa dem entspricht, was ein Beobachter auf See meldet. Einzelne Wellen erreichen etwa das Doppelte, und das ist die Zahl, auf die es ankommt, wenn Sie entscheiden, ob Sie hinausfahren. Die Richtung ist die, aus der die Wellen kommen, wie bei der Windrichtung.

Flüsse#

Dieser Endpunkt beantwortet, was kein Wettermodell kann: nicht, wie viel Regen flussaufwärts fällt, sondern wie viel Wasser hier ankommt — eine ganz andere Zahl, vom Regen getrennt durch ein Einzugsgebiet, einen Bodenfeuchtezustand und ein bis zwei Tage Laufzeit.

{
  "disclaimer": "Information only. Only national and regional authorities
                 are authorised to issue flood warnings.",
  "daily": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "river_discharge": [4.953],
    "soil_wetness_index": [0.448]
  }
}