meteoCORE API-Dokumentation

Zentrales API-Gateway der meteoCORE UG (haftungsbeschränkt) aus Wölfersheim: Wettermodell-Kacheln (7 NWP-Modelle), Radar, Wetter- und Luftqualitätsstationen, Punktprognosen sowie Geocoding — für die B2C-API (api.meteocore.com) und die B2B-Premium-API (premium-api.meteocore.com).

Verfügbare Wettermodelle (Modellkarten, `/api/v1/models`)

Sieben numerische Wettervorhersagemodelle (NWP) stehen als georeferenzierte PNG-Kacheln (Web-Mercator, 256×256px) sowie als rohwert-kodierte Kacheln zur Verfügung:

ICON-D2 (Deutscher Wetterdienst, openData) — hochauflösendes Regionalmodell für Mitteleuropa mit rund 2,2 km nativer Gitterweite, 8 Läufe täglich (00/03/06/09/12/15/18/21 UTC), Vorhersage stündlich bis 48 Stunden. Die feine Auflösung bildet konvektive Ereignisse wie Gewitterzellen und Starkregen deutlich direkter ab als die gröberen Modelle.
ICON-D2-RUC (DWD) — Rapid-Update-Cycle-Variante von ICON-D2: identisches Modellgebiet und identische ~2,2-km- Auflösung, aber stündliche statt 3-stündliche Läufe (24 Läufe/Tag) für eine besonders aktuelle Kurzfristvorhersage bis 27 Stunden — ideal für Nowcasting.
ICON-EU (DWD) — paneuropäisches Modell mit engerem Gitter als das globale Modell, 8 Läufe täglich, davon vier Hauptläufe (00/06/12/18 UTC) mit Vorhersage stündlich bis Stunde 78 und danach 3-stündlich bis 120 Stunden. Die vier Zwischenläufe (03/09/15/21 UTC) liefern denselben Parametersatz mit kürzerer Vorhersagedauer.
ICON Global (DWD) — globales Modell auf einem Dreiecksgitter mit rund 13 km nativer Auflösung, 4 Läufe täglich (00/06/12/18 UTC), Vorhersage stündlich bis Stunde 78, danach 3-stündlich bis Stunde 180.
AICON (DWD) — DWDs KI-basiertes Vorhersagemodell: lernt die zeitliche Entwicklung des Wetters direkt aus der ICON-DREAM-Reanalyse, statt die physikalischen Bewegungsgleichungen numerisch zu integrieren. 4 Läufe täglich, durchgehend 3-stündliche Vorhersage bis Stunde 120, aktuell mit einem reduzierten Parametersatz (u.a. Temperatur, Niederschlag, Wind, Feuchte).
GFS 0.25° (NOAA/NCEP, via AWS Open Data) — das globale Modell des US-Wetterdienstes in seiner nativen 0,25-Grad-Auflösung (seit der GFS-v16-Umstellung 2021), 4 Läufe täglich, Vorhersage stündlich bis Stunde 120 und danach 3-stündlich bis Stunde 384 (16 Tage) — der Modellhorizont mit der weitesten Reichweite im Angebot.
ECMWF IFS HRES 0.25° (ECMWF Open Data, enthält modifizierte Copernicus-Daten) — das globale High-Resolution- Modell des Europäischen Zentrums für mittelfristige Wettervorhersage, hier in der frei verfügbaren 0,25-Grad-Auflösung (die native ~9-km-Auflösung ist nicht Teil des kostenlosen Angebots). 4 Läufe täglich, davon zwei Hauptläufe (00/12 UTC) mit Vorhersage 3-stündlich bis Stunde 144 und danach 6-stündlich bis Stunde 360 (15 Tage); die Zwischenläufe (06/18 UTC) liefern eine kürzere Schedule.

Wichtige Parameter

Jedes Modell liefert einen an seine Rohdatenquelle angepassten Parametersatz (vollständige Liste je Modell unter /api/v1/models/{model}/params); die folgenden Felder sind bei den meisten der sieben Modelle vertreten:

t2m — Temperatur 2m (°C): Lufttemperatur 2 Meter über Grund, das meistgenutzte Feld. Abgeleitete Varianten wie tmax2m/tmin2m (Höchst-/Tiefsttemperatur im jeweiligen Aggregationsfenster) und t2m_land (nur über Landflächen) stehen bei den DWD-Modellen zusätzlich bereit.
precip_total, precip_1h/_3h/_6h/_12h/_24h — Niederschlag (mm): precip_total ist der seit Laufbeginn akkumulierte Niederschlag; die Intervall-Varianten werden serverseitig als Differenz zweier Steps berechnet und liefern die tatsächliche Niederschlagsmenge im jeweiligen Zeitfenster.
wind_10m / winddir_10m — Mittelwind (km/h) und Windrichtung (°): Windgeschwindigkeit und -richtung in 10 Metern Höhe, aus den U/V-Windkomponenten des Modells abgeleitet. windgust_1h/_3h/_6h ergänzen die maximale Böengeschwindigkeit im jeweiligen Intervall — wichtig für Unwetterwarnungen.
relhum_2m — Relative Feuchte 2m (%): Zusammen mit d2m (Taupunkt 2m, °C) die Standardfelder zur Einschätzung von Schwüle-, Nebel- und Reifgefahr.
ww / sigww — Signifikantes Wetter: Kategorialer WMO-Wettercode (Regen, Schnee, Gewitter, Nebel etc.), je Modell auf die verfügbare DWD-Kodierung gemappt — die Grundlage für Wettersymbole im Frontend.
cape_ml / cin_ml — Konvektive Energie / Hemmung (J/kg): Maß für die atmosphärische Labilität bzw. den Deckel darüber — zentrale Kenngrößen zur Einschätzung des Gewitter- und Unwetterpotenzials, bei ICON-D2/-D2-RUC zusätzlich in weiteren Varianten (cape_con, cape_mu/cin_mu für die instabilste statt durchmischte Schicht).
t_850hpa, t_700hpa, t_500hpa, t_300hpa (analog wind_*, relhum_*, geopot_*) — Druckflächenparameter: Temperatur, Wind, Feuchte und geopotenzielle Höhe auf festen Druckflächen statt in Bodennähe — Grundlage für Höhenwetterkarten und Analysen der freien Atmosphäre, etwa zur Frontenanalyse oder Höhenströmung.
dbz_850 / dbz_cmax / dbz_ctmax — Radarreflektivität (dBZ, nur ICON-D2/-D2-RUC): Modellierte Radar-Basisreflektivität in 850 hPa sowie die maximale Reflektivität in der Säule (instantan bzw. im Zeitintervall) — ein Proxy für Niederschlagsintensität direkt aus dem Modell, unabhängig vom echten Radarnetz (siehe dazu die separate /api/v1/radar-Gruppe).

Ergänzend zu den Modellkarten liefert die Forecast-Gruppe (/api/v1/forecast/{model}/point/{timestamp}) für ICON-D2 und ICON-EU bilinear interpolierte Punktprognose-Zeitreihen für beliebige Koordinaten, standardmäßig höhenkorrigiert per DEM-Lookup.

Diese Seite benötigt JavaScript, um die interaktive Swagger-UI darzustellen. Die vollständige OpenAPI-3.1-Spezifikation steht auch direkt als Rohdatei zur Verfügung.