Wetter-API · 1,3 km bis 28 km · 15 Tage
Das feinste Modell, das Ihren Punkt abdeckt. Pro Anfrage gewählt.
Die meisten Wetter-APIs fahren überall ein einziges globales Modell. Diese hält 8 und entscheidet, welches eine gegebene Koordinate zu einer gegebenen Vorlaufzeit beantwortet — damit ein Alpendorf nicht dieselbe 28-km-Zelle bekommt wie der offene Atlantik.
Dieselben 120 km Küste, wie jedes Modell sie sieht 28 km die Bucht ist weg 1.3 km die Insel existiert
Auflösung ist kein Detail im Datenblatt. Sie entscheidet, ob eine Bucht, ein Tal oder eine Insel im Modell überhaupt vorkommt — und eine Zelle, die Meer und Land mittelt, gibt Ihnen die Temperatur von keinem von beidem.
8 Modelle, automatisch aufgelöst
Sie wählen nie ein Modell. Sie senden eine Koordinate; die API nimmt das feinste, das sie abdeckt, mischt über Domänenränder, damit der Wert nicht springt, und nennt in der Antwort das Modell, das geantwortet hat.
| Modell | Auflösung | Abdeckung | Läufe | Horizont | Verfügbar nach |
|---|---|---|---|---|---|
| Météo-France AROME | 1.3 km | Frankreich und nahe Nachbarn | 8 ×/Tag | 51 h | 4 h |
| DWD ICON-D2 | 2.2 km | Mitteleuropa | 4 ×/Tag | 48 h | 2 h |
| NOAA HRRR | 3 km | Kontinentale USA | 4 ×/Tag | 48 h | 1.5 h |
| DWD ICON-EU | 6.5 km | Europa, Nordafrika, Naher Osten | 2 ×/Tag | 120 h | 3 h |
| DWD ICON | 13 km | Weltweit | 2 ×/Tag | 180 h | 4 h |
| ECMWF IFS | 28 km | Weltweit — immer vorhanden | 2 ×/Tag | 240 h | 7 h |
| ECMWF AIFS | 28 km | Weltweit, Tag 11–15 | 2 ×/Tag | 360 h | 7 h |
| ECMWF wave | 28 km | Nur Ozeane und Meere | 2 ×/Tag | 240 h | 7 h |
Domänenränder
Keine Naht, wo ein Modell endet
Abrupt an einer Grenze das Modell zu wechseln lässt zwei Nachbarorte ohne physikalischen Grund auseinanderlaufen. Jede Domäne trägt einen Mischsaum: nahe dem Rand fällt das Gewicht des feinen Modells ab, und der Rest geht an das nächstgröbere. Innerhalb der Domäne bekommen Sie das feine Modell unvermischt.
Vorlaufzeit
Früh fein, später global
AROME endet bei 51 Stunden und HRRR bei 48. Danach fällt der Resolver über ICON-EU und ICON auf ECMWF zurück, in derselben Anfrage. Ihre Siebentagereihe ist aus dem jeweils besten Modell zusammengesetzt, und die Antwort hält die Mischung fest.
Was zurückkommt
45 stündliche Felder — 27 gespeichert, 18 zur Laufzeit berechnet. 21 kommen standardmäßig zurück; die übrigen nennen Sie in hourly=, oder Sie nennen weniger und verkleinern die Antwort.
Temperatur & Feuchte
temperature_2m, Tagesmaximum und -minimum, dewpoint_2m, relative Feuchte, gefühlte Temperatur, Hitzeindex, Windchill, Oberflächentemperatur.
Wind
u/v-Komponenten in 10 m und 100 m für die Windenergie, Geschwindigkeit, Richtung, Himmelsrichtung, Beaufortstärke und wind_gust_10m.
Niederschlag
Gesamtniederschlag je Intervall dekumuliert, Schneefall als Wasseräquivalent, und ein WMO-Code precipitation_type, der Regen, Schnee und gefrierenden Regen trennt.
Bewölkung & Sicht
Gesamtbedeckung plus tief, mittel und hoch getrennt — tiefe Wolken machen den Tag grau, Zirren dämpfen die Sonne kaum. Okta für die Luftfahrt und visibility für Nebel.
Strahlung & Sonne
Kurzwellige Einstrahlung, aufgeteilt in Direkt- und Diffusanteil für den Photovoltaikertrag. Sonnenhöhe und -azimut, Tageslicht-Flag, Sonnenauf- und -untergang und ein geschätzter UV-Index.
Druck & Labilität
Luftdruck auf Meereshöhe und am Boden, Drucktendenz über drei Stunden, cape für das konvektive Potenzial und der Gesamtwasserdampf der Säule.
Boden
Bodentemperatur an der Oberfläche und in der Wurzelzone 7–28 cm — der für die Landwirtschaft entscheidenden Schicht — aus ICON. soil_temperature_0cm und soil_temperature_8cm.
Schnee
Höhe, Wasseräquivalent, Nullgradgrenze und snow_line_altitude — die Höhe, oberhalb derer Niederschlag als Schnee fällt, und damit eine Entscheidung, auf die eine Straßenmeisterei reagieren kann.
Zusammenfassung
Ein einziger WMO-weather_code je Zeitschritt, damit der Client ein Symbol zeichnet, statt die Logik nachzubauen, die aus sieben Feldern „leichter Regen“ macht.
Zwei Korrekturen, die die meisten APIs auslassen
Höhe
Der Berg des Modells ist nicht Ihr Berg
Ein numerisches Modell glättet das Gelände auf sein Gitter. Ein Dorf im Tal kann 400 m unter der Höhe liegen, die das Modell ihm zuschreibt, und die rohe Temperatur ist um den Temperaturgradienten über diese Differenz falsch.
Senden Sie elevation mit Ihrer Anfrage, und der Wert wird gegen die Orographie des Modells korrigiert. Im Bergland sind das typisch 1–3 °C. Die Antwort nennt die Modellhöhe, Ihre Höhe und den angewandten Versatz — Sie können ihn also prüfen oder ignorieren.
Aktualität
Veraltet schlägt fehlend, und sagt es
Ist unser neuester Lauf älter als erwartet, bekommen Sie trotzdem Daten, mit "stale": true und data_age_hours im Block source. Eine acht Stunden alte Vorhersage nützt Ihren Nutzern mehr als ein 500er.
Was Sie nie bekommen, ist eine veraltete Zahl, die frisch aussieht. Entscheiden Sie in Ihrem eigenen Code, ob Sie sie zeigen, warnen oder ausweichen.
{
"grid": { "distance_km": 8.04, "resolution_km": 28.0 },
"elevation": {
"applied": true,
"model_elevation_m": 91.0,
"location_elevation_m": 113,
"temperature_offset_c": -0.14
},
"source": {
"model": "ecmwf_ifs",
"model_run": "20260725T00Z",
"data_age_hours": 8.95,
"stale": false,
"attribution": "Data: ECMWF (CC-BY-4.0)"
}
}Auf demselben Schlüssel, nicht auf der nächsten Rechnung
Vier Dinge, die anderswo üblicherweise eigene Produkte sind. Hier sind es Endpunkte auf dem Plan, den Sie bereits gekauft haben.
/v1/probability
Wie sicher ist die Vorhersage?
Ein Einzelwert sagt 22 °C am Donnerstag — eine Vermutung, als Tatsache serviert. Dies liefert p10, p50, p90 und die Streuung aus dem 50-Member-Ensemble des ECMWF, dazu Regenwahrscheinlichkeiten bei 0,1, 1, 5 und 10 mm.
Eine Streuung von 0,4 °C ist eine gefestigte Lage. Eine Streuung von 3 °C heißt, dass die Atmosphäre selbst unsicher ist, und Ihre Nutzer haben es verdient, das zu erfahren.
/v1/air-quality
Feinstaub, Ozon, NO₂ — und Saharastaub
Von Copernicus CAMS, mit WHO-Richtwerten in jeder Antwort, damit eine Zahl eingeordnet werden kann, ohne sie nachzuschlagen.
Staub zählt in Nordafrika und im Mittelmeerraum: eine Episode treibt PM10 tagelang über tausend µg/m³, und kostenlose Verbraucherdienste decken das schlecht ab.
/v1/marine
Seegang weltweit
Signifikante Wellenhöhe, Richtung und Periode aus dem ECMWF-Wellenmodell, bis zehn Tage. Ein Punkt an Land liefert 404 not_at_sea statt einer Spalte Nullwerte, die wie ein Ausfall aussieht.
/v1/hydrology
Wie viel Wasser hier ankommt
Flussabfluss von Copernicus GloFAS auf einem 0,05°-Flussnetz — nicht wie viel Regen flussaufwärts fällt, sondern wie viel Wasser diesen Punkt erreicht, wovon ein Einzugsgebiet und ein Tag Laufzeit trennen.
Nur zur Information. Hochwasserwarnungen auszugeben ist nationalen und regionalen Behörden vorbehalten.
Wo es arbeitet
Wetterprodukte
Stadtseiten, Apps und Widgets. Ein WMO-Code je Schritt für das Symbol, Tagesaggregate in der Zeitzone des Nutzers geschnitten, und ein Städtekatalog mit Suche und Nächster-Punkt-Abfrage.
Energie
100-m-Wind für die Nabenhöhe, direkte und diffuse Einstrahlung für den PV-Ertrag, und Ensemble-Streuung für die Risikoseite einer Position.
Landwirtschaft
Bodentemperatur und -feuchte in vier Tiefen, Eingangsgrößen für die Verdunstung, Frostrisiko aus der Minimumtemperatur und Böen für Spritzfenster.
Logistik & Straßen
Schneefallgrenze, Nullgradgrenze, Niederschlagsart und Sicht — die vier Felder, die entscheiden, ob ein Pass gesperrt wird.
See & Outdoor
Wellenhöhe, -periode und -richtung, Windböen, UV-Index und Tageslicht für Planung, die eine Woche im Voraus stattfinden muss.
Wiederverkäufer
Sie dürfen weiterverbreiten. Bauen Sie ein Produkt darauf und verkaufen Sie es; eine Fußzeile mit Quellenangabe ist die einzige Pflicht, die Ihnen folgt.
Was sie schlecht kann
Uns ist lieber, Sie kennen die Grenzen jetzt, als dass Sie sie in der Produktion finden.
Stark
Temperatur, Druck, synoptischer Wind, Feuchte, Sonnenschein. Der typische Fehler der 2-m-Temperatur nach 24 Stunden liegt bei etwa 1–1,5 °C. ECMWF ist das beste globale deterministische Modell der Welt, und genau das bekommen Sie.
Schwach
Konvektive Gewitter — eine 28-km-Zelle kann kein Gewitter auflösen, und selbst 3 km deuten es nur an. Genaue Lage und Zeit von Schauern. Küsten- und Bergmikroklima unterhalb der Modellauflösung. Seewind und Kaltluftseen in Tälern, die die Höhenkorrektur nicht abbildet.
Geografisch ehrlich
In Frankreich, Deutschland, den USA und Kanada liefern wir nationale Modelle mit 1,3–3 km, und ein kleines Dorf bekommt wirklich seine eigene Gitterzelle. Überseegebiete, Alaska, Hawaii und Nordkanada liegen außerhalb dieser Domänen und fallen auf 13 km zurück. Sonst in Europa sind es 6,5 km. In Afrika, dem Nahen Osten und dem größten Teil Asiens ist das beste öffentlich verfügbare Modell 13–28 km: Sie bekommen das Wetter der Gegend statt das der Straße. Die Höhenkorrektur verkleinert diese Lücke; sie schließt sie nicht.
Kein Warndienst
Keine Warnungen, keine Warnstufenfarben, keine Handlungsanweisung. Das gehört den Behörden, die auch eine Straße sperren und ein Dorf evakuieren können.
Häufige Fragen
Welches Modell bedient meinen Standort?
Das feinste, das ihn abdeckt: AROME mit 1,3 km in Frankreich, ICON-D2 mit 2,2 km in Mitteleuropa, HRRR mit 3 km in den USA, ICON-EU mit 6,5 km über Europa und Nordafrika, ICON mit 13 km weltweit, und ECMWF IFS mit 28 km als immer vorhandene Grundlage.
Rufen Sie /v1/models für die aktuelle Registrierung und die Domäne jedes Modells auf, oder lesen Sie source.model in jeder Antwort.
Wie oft wird aktualisiert?
Globale Modelle zweimal täglich um 00 und 12 UTC; die hochauflösenden nationalen Modelle viermal täglich um 00, 06, 12 und 18 UTC. Die Daten werden je nach Anbieter zwischen 90 Minuten und 7 Stunden nach der Laufzeit nutzbar — die Tabelle oben nennt jeden einzeln.
Vorhersageantworten werden fünf Minuten am Rand zwischengespeichert, was den wiederholten Verkehr der Stadtseiten abfängt, ohne je einen Lauf auszuliefern, der hinter unserem zurückliegt.
Kann ich viele Orte auf einmal abfragen?
Eine Koordinate pro Anfrage. Der Speicher ist so aufgeteilt, dass die gesamte Zeitreihe eines kleinen Gebiets in einem Block liegt — ein Punkt über alle Schritte ist die billige Abfrage, und es ist die, die praktisch jedes Produkt tatsächlich stellt.
Für stadtförmigen Verkehr trägt /v1/forecast/city/{country}/{slug} Zeitzone und Höhe der Stadt, damit Sie es nicht müssen.
Gibt es einen Massendownload?
Nein, in keinem Plan. Das Archiv ist das, wofür Sie bezahlen, und ein unbegrenzter Export ist die Art, wie ein Wettbewerber es sich an einem Nachmittag beschafft. Den CSV-Export für Gradtage gibt es, und er ist bewusst begrenzt.
Was kostet das?
Kostenlos für 10.000 Credits im Monat, ohne Karte. 19 € im Monat für 50.000 Credits inklusive Gradtage-API, Historie und CSV. 79 € für 400.000 Credits und alles Übrige. Eine Vorhersageanfrage ist ein Credit.
Probieren Sie es an Ihren eigenen Koordinaten
Die kostenlose Stufe liefert dieselben Daten wie die bezahlten. Richten Sie sie auf einen Ort, den Sie gut kennen, und beurteilen Sie die Zahlen selbst.