Gradtage-API · ERA5-Land 9 km · 1950 →
Ihre Basistemperatur. Nicht Basis 18.
Ein Gebäude mit einem Gleichgewichtspunkt von 15,5 °C kann mit einem HGT18-Wert nichts anfangen. Wir behalten die stündliche Temperatur und integrieren sie gegen die Basis, nach der Sie fragen, zum Anfragezeitpunkt — das ist der Unterschied zwischen einer Zahl, auf die Sie abrechnen können, und einer, für die Sie sich entschuldigen müssen.
18.0
660
1 267
Algier · ein Jahr Tagesmitteltemperatur Blau Heizbedarf Orange Kühlbedarf
Die eingefärbte Fläche ist der Gradtag. Ziehen Sie die Basis und sehen Sie zu, wie die beiden Summen die Plätze tauschen — dieser Tausch ist der ganze Grund, warum die Basis Ihre sein muss. Diese Abbildung nutzt die Tagesmittelmethode, damit sie in Ihrem Browser laufen kann; die API integriert die stündliche Reihe und reproduziert diese Summen bei Basis 18.
1950 →
76 Jahre, stündlich. Der spezialisierte Wettbewerber startet im Jahr 2000.
4
Berechnungsmethoden, weil Ihr Vertrag entscheidet, nicht wir.
9 km
Gitter, überall an Land — keine Station in der Nähe nötig.
frei
Basistemperatur, auch mit Nachkommastellen, zur Anfragezeit aufgelöst.
Warum kostenlose Gradtagsdaten meist unbrauchbar sind
Die Basis
HGT18 ist die Antwort eines einzigen Gebäudes
Gradtage auf Basis 18 vorzuberechnen ist die naheliegende Abkürzung, und genau das macht die meisten kostenlosen Datensätze kommerziell unbrauchbar. Ein gut gedämmtes Büro mit inneren Lasten liegt eher bei 15 °C; eine zugige Lagerhalle eher bei 19. Mit einer HGT18-Reihe bekommen beide eine Zahl, die keines von beiden beschreibt.
Wir speichern stattdessen die stündliche Temperatur und integrieren, wenn Sie fragen. Die Basis ist ein Abfrageparameter.
Die Mittelung
Ein Tagesmittel versteckt den Tag
Ein Tag, der von 8 °C auf 22 °C schwang, hat ein Mittel von 15 °C. Gegen eine Basis von 18 sieht das nach einem milden Tag mit mäßigem Heizbedarf aus. Tatsächlich hat das Gebäude die ganze Nacht kräftig geheizt und brauchte am Nachmittag nichts mehr.
Stündliche Integration bewahrt das. Es ist eine andere Zahl, und es ist die richtige — sofern Ihr Vertrag nichts anderes sagt, wozu siehe unten.
Vier Methoden, weil Ihr Vertrag entscheidet
Das ist das Detail, das B2B-Abschlüsse entscheidet. Unsere stündliche Integration ist die physikalisch treueste — und nutzlos für einen Kunden, dessen Vertrag auf Costic geschrieben ist, weil seine Zahlen nicht passen werden. Also ist die Methode ein Parameter.
| method= | HGT 18 °C | KGT 18 °C | Wann man sie nimmt |
|---|---|---|---|
hourly |
781.9 | 1331.6 | Standard. Integriert das stündliche Defizit oder den Überschuss — die physikalisch treueste. |
costic |
741.7 | 1349.5 | Französische DJU unifiés. Vorgeschrieben in französischen Energieleistungsverträgen. |
mean |
659.9 | 1267.8 | Tagesmittel gegen die Basis. Die international am weitesten verbreitete Konvention. |
eurostat |
587.7 | 656.6 | Europäische Statistik. Die Basen sind durch die Definition festgelegt und ignorieren base. |
Dieselben Daten, dieselbe Basis, dasselbe Jahr, derselbe Ort — und 18 % Spanne zwischen der ersten und der dritten Zeile. Wer Ihnen „die Gradtage“ reicht, ohne die Methode zu nennen, hat Ihnen eine Zahl gereicht, die Sie nicht abgleichen können. /v1/degree-days/compare-methods liefert alle vier auf einmal, damit Sie diejenige finden, die die Zahlen in Ihrem Vertrag reproduziert — bevor Sie sich auf einen Plan festlegen.
Vier Entscheidungen, die auf Ihren Rechnungen auftauchen
Kalender
Lokale Tage, keine UTC-Tage
Ein Gradtag ist eine Eigenschaft eines Kalendertags dort, wo das Gebäude steht. Nach UTC zu bündeln verschiebt ein Stück jeder Nacht in den falschen Tag und verzerrt still die Monatssummen. Jede Anfrage nimmt den Versatz des Ortes und gruppiert entsprechend; die Stadt-Endpunkte kennen ihre eigene Zeitzone.
Städte
Die städtische Wärmeinsel, kalibriert
Die Reanalyse unterschätzt bebaute Gebiete um 1–3 °C, was die Kühlgradtage nach unten verzerrt — wesentlich, wenn Sie eine Klimaanlage auslegen. Stadt-Endpunkte wenden einen Versatz an, der gegen echte Stationsmessungen bestimmt wurde: Algier +0,48 °C, Paris +1,13 °C.
Koordinaten-Endpunkte wenden ihn nicht an und sagen das auch.
Zeiträume
Täglich, wöchentlich, monatlich, jährlich
Alle vier in derselben Anfrage, weil Verträge sich auf unterschiedliche festlegen. Wochen sind ISO-Wochen, der 1. Januar 2023 wird also in Woche 52 von 2022 ausgewiesen — was Ihre Tabellenkalkulation auch tun wird. Jeder Eimer trägt seine Tageszahl, damit ein angeschnittener Monat am Rand eines Zeitraums sichtbar ist statt still zu kurz.
Qualität
Abdeckung, und was vorläufig ist
Jede Antwort trägt einen quality-Block: vorhandene Stunden, Abdeckung unter 1.0, sobald welche fehlen, und eine Zahl von provisional_days, die aus der Vorhersage statt aus der endgültigen Reanalyse gefüllt wurden — ERA5-Land erscheint mit etwa fünf Tagen Verzug. Sie sehen genau, welcher Teil einer Summe noch nicht endgültig ist.
Eine Anfrage, zehn Jahre, eine Zahl
# Paris, britische Basis 15,5 °C, zehn Jahre, Monatszeilen
curl -H "X-API-Key: $API_KEY" \
"https://api.climatememory.com/v1/degree-days\
?lat=48.86&lon=2.35&base=uk&breakdown=monthly\
&start=2015-01-01&end=2024-12-31"
# Dasselbe Gebäude, mit der Methode aus seinem Vertrag
curl -H "X-API-Key: $API_KEY" \
"https://api.climatememory.com/v1/degree-days/city/fr/paris\
?base=18&method=costic&start=2024-01-01&end=2024-12-31"import httpx
# Ein Portfolio witterungsbereinigen: gleiche Basis, gleiche Methode, viele Standorte
def hdd(lat, lon, year, base=15.5, method="hourly"):
r = httpx.get(
"https://api.climatememory.com/v1/degree-days",
params={"lat": lat, "lon": lon, "base": base,
"method": method, "type": "HDD",
"start": f"{year}-01-01", "end": f"{year}-12-31"},
headers={"X-API-Key": API_KEY}, timeout=60,
)
r.raise_for_status()
return r.json()["totals"]["hdd"]
ratio = hdd(48.86, 2.35, 2024) / hdd(48.86, 2.35, 2023)
# Verbrauch +9 %, Gradtage +11 % -> das Gebäude wurde besser{
"location": { "latitude": 36.75, "longitude": 3.06,
"grid_cell": { "distance_km": 6.61, "resolution_km": 9 } },
"parameters": { "base_temperature_c": 18.0, "method": "hourly",
"start": "2025-07-01", "end": "2026-06-30" },
"totals": { "hdd": 781.86, "cdd": 1331.61 },
"quality": { "days": 365, "coverage": 1.0,
"missing_hours": 0, "provisional_days": 0 },
"breakdown": [ { "year": 2025, "month": 7, "hdd": 0.0,
"cdd": 289.4, "days": 31 } ]
}# format=csv an jede Gradtage-Anfrage anhängen. Nur in Bezahlplänen.
year,month,hdd,cdd,days,t_mean,coverage,provisional
2024,1,205.03,2.88,31,11.48,1.0,false
2024,2,168.44,4.10,29,12.31,1.0,false
2024,3,131.77,9.62,31,14.05,1.0,false
# Die Datei trägt Ort und Datum im Namen und ist deshalb auch
# sechs Monate später im Download-Ordner noch erkennbar.Wer das kauft, und wofür
Energieleistungsverträge
Das Jahr abrechnen, ohne über das Wetter zu streiten
Ein Einsparcontracting muss „das Gebäude wurde besser“ von „der Winter war mild“ trennen. Gradtage auf der Basis und der Methode des Vertrags sind die Art, wie diese Trennung festgehalten wird — und method=costic ist das, was ein französischer Vertrag nennen wird.
Portfoliomanagement
400 Gebäude in 12 Ländern vergleichen
Jeder Standort bekommt seinen lokalen Kalender, seine Gitterzelle und, in Städten, seine Wärmeinsel-Korrektur — auf einer Basis und einer Methode, damit der Vergleich etwas bedeutet. Keine Stationsabdeckung vorab zu prüfen.
HLK-Auslegung
Kühllast gegen ein echtes Kühlklima
KGT auf der Basis, bei der die Anlage tatsächlich ins Gleichgewicht kommt, in der Innenstadt statt am Flughafen, wo das Reanalysegitter am kühlsten ist. 76 Jahre davon, damit ein Auslegungsjahr gewählt und nicht angenommen wird.
Softwareanbieter
Gradtage im eigenen Produkt ausliefern
Kommerzielle Weiterverbreitung ist erlaubt. Setzen Sie die Zahlen in Ihre Energiemanagement-Plattform, Ihre Abrechnung oder Ihren ESG-Bericht; eine Zeile Quellenangabe ist die einzige Pflicht, die Ihnen folgt.
Woher die Zahlen kommen
ERA5-Land, die Copernicus-Reanalyse. Ein physikalisches Modell, rückwärts über jede je assimilierte Beobachtung gerechnet, das ein stündliches Temperaturfeld auf einem 9-km-Gitter erzeugt, überall an Land, von 1950 bis vor etwa fünf Tagen.
Warum das für diese Aufgabe eine Stationsreihe schlägt. Eine Wetterstation trägt jeden Umzug, jeden Gerätewechsel und jede Lücke ihrer Geschichte mit sich; ein aus ihr berechneter Dreißigjahrestrend ist teils ein Trend der Messtechnik. Eine Reanalyse hat davon nichts. Sie hat auch keine Abdeckungslücken: ein Standort 60 km von der nächsten Station wird genauso gut bedient wie einer direkt am Flughafen.
Wo sie schwächer ist. Innenstädte, die die Reanalyse unterschätzt — daher die kalibrierte Korrektur an den Stadt-Endpunkten. Und die letzten fünf Tage, die vorläufig bleiben, bis die endgültige Reanalyse eintrifft; die Antwort zählt diese Tage für Sie.
Die Lizenz, um die es geht. Copernicus veröffentlicht ERA5-Land unter CC-BY-4.0: kommerzielle Nutzung, Weiterverbreitung und abgeleitete Werke sind ausdrücklich erlaubt. Das macht daraus ein Produkt statt eines Forschungsdownloads.
Häufige Fragen
Was genau ist ein Gradtag?
Ein Maß dafür, wie weit und wie lange die Außentemperatur unter oder über einem Bezugswert lag, der Basis heißt. Heizgradtage sammeln sich, wenn es kälter als die Basis ist, Kühlgradtage, wenn es wärmer ist.
Sie sind die übliche Art zu erklären, warum ein Gebäude diesen Januar mehr Energie verbraucht hat als letzten, ohne Wetter mit Verhalten zu verwechseln.
Kann ich jede Basistemperatur nutzen?
Jeden Wert, auch mit Nachkommastellen. Benannte Vorgaben werden ebenfalls akzeptiert: uk (15,5 °C), ashrae (18,333 °C, also 65 °F), iso, france und eurostat (18 °C).
Unterschiedliche Basen für Heizen und Kühlen sind in derselben Anfrage möglich, denn ein Gebäude kommt selten in beide Richtungen am selben Punkt ins Gleichgewicht.
Unterstützen Sie DJU unifiés / Costic?
Ja — method=costic. Sie nutzt nur Tagesminimum und -maximum mit einer empirischen Gewichtung für Tage, die die Basis überspannen, worauf sich französische Energieleistungsverträge festlegen.
Lassen Sie /v1/degree-days/compare-methods über einen Zeitraum laufen, für den Sie bereits Zahlen haben. Reproduziert Costic sie, nehmen Sie Costic. Diese Prüfung kostet eine Anfrage und verhindert die Diskussion.
Wie weit reicht das Archiv zurück?
Bis zum 1. Januar 1950 — 76 Jahre, stündlich, weltweit an Land, auf einem 9-km-Gitter. Eine einzelne Anfrage darf bis zu 10 Jahre umfassen; längere Historien sind mehrere Anfragen.
Brauche ich eine Wetterstation in der Nähe?
Nein. Die gerasterte Reanalyse deckt jeden Landstandort ab, auch solche ohne Station im Umkreis von 60 km. Das ist ihr wesentlicher Vorteil gegenüber stationsbasierten Gradtagsanbietern, neben fehlenden Gerätewechseln und Lücken in der Geschichte.
Kann ich nach CSV oder Excel exportieren?
Hängen Sie format=csv an jede Gradtage-Anfrage in einem Bezahlplan. Sie bekommen die aggregierten Zeilen — nie die stündliche Reihe — mit derselben Höchstspanne wie der JSON-Aufruf, zum vierfachen Creditpreis.
Diese Grenze ist bewusst und nicht widerwillig: das Archiv ist das, wofür Sie zahlen, und ein unbegrenzter Export ist die Art, wie ein Wettbewerber es sich an einem Nachmittag beschafft. Erst die Grenze lässt das Format überhaupt existieren.
Was kostet das?
Gradtage sind ab dem Starter-Plan für 19 € im Monat enthalten: 50.000 Credits, Wetter inklusive, CSV inklusive. Eine Gradtage-Anfrage kostet zwei Credits bis zu einem Jahr, plus einen je weiterem Jahr.
Bei 50.000 Credits sind das rund 25.000 Einjahresabfragen im Monat — genug für ein Portfolio von einigen hundert Gebäuden, täglich abgefragt.
Darf ich die Werte in meinem eigenen Produkt weiterverkaufen?
Ja. ERA5-Land erscheint unter CC-BY-4.0, was kommerzielle Nutzung, Weiterverbreitung und abgeleitete Werke erlaubt. Zeigen Sie eine Quellenangabe überall dort, wo die Daten erscheinen — /v1/attribution liefert den exakten Wortlaut und braucht keinen Schlüssel.
Prüfen Sie es gegen Zahlen, die Sie schon haben
Nehmen Sie ein Jahr mit abgenommenen Zahlen, lassen Sie compare-methods laufen und sehen Sie, welche Methode sie reproduziert. Das ist die ehrliche Art, dies zu kaufen.