Graaddagen-API · ERA5-Land 9 km · 1950 →
Uw basistemperatuur. Niet basis 18.
Een gebouw met een balanspunt van 15,5 °C kan niets met een graaddagencijfer op basis 18. Wij bewaren de uurlijkse temperatuur en integreren die tegen de basis die u vraagt, op het moment van de aanvraag — dat is het verschil tussen een getal waarop u kunt factureren en een getal waarvoor u zich moet verontschuldigen.
18.0
660
1 267
Algiers · een jaar daggemiddelde temperatuur Blauw warmtevraag Oranje koudevraag
Het gekleurde vlak is de graaddag. Sleep de basis en zie de twee totalen van plaats wisselen — die wisseling is precies waarom de basis de uwe moet zijn. Deze figuur gebruikt de daggemiddelde methode zodat ze in uw browser kan draaien; de API integreert de uurreeks en reproduceert deze totalen op basis 18.
1950 →
76 jaar, uurlijks. De gespecialiseerde concurrent begint in 2000.
4
Rekenmethoden, omdat uw contract beslist en wij niet.
9 km
Raster, overal op het land — geen station in de buurt nodig.
vrij
Basistemperatuur, decimalen inbegrepen, bij de aanvraag opgelost.
Waarom gratis graaddagen meestal onbruikbaar zijn
De basis
Basis 18 is het antwoord van één gebouw
Graaddagen voorberekenen op basis 18 is de voor de hand liggende afkorting, en het is wat de meeste gratis datasets commercieel onbruikbaar maakt. Een goed geïsoleerd kantoor met interne warmtelast balanceert eerder rond 15 °C; een tochtige loods eerder rond 19. Met een reeks op basis 18 krijgen beide een getal dat geen van beide beschrijft.
Wij bewaren in plaats daarvan de uurlijkse temperatuur en doen de integratie wanneer u het vraagt. De basis is een queryparameter.
Het middelen
Een daggemiddelde verbergt de dag
Een dag die van 8 °C naar 22 °C zwaaide heeft een gemiddelde van 15 °C. Tegen een basis van 18 lijkt dat een milde dag met bescheiden warmtevraag. In werkelijkheid stookte het gebouw de hele nacht hard en had het 's middags niets meer nodig.
Uurlijks integreren houdt dat vast. Het is een ander getal, en het is het juiste — tenzij uw contract iets anders zegt, en dan zie hieronder.
Vier methoden, omdat uw contract beslist
Dit is het detail dat B2B-deals beslecht. Onze uurlijkse integratie is fysisch het meest getrouw — en nutteloos voor een klant wiens contract op Costic is geschreven, want zijn getallen zullen niet kloppen. Daarom is de methode een parameter.
| method= | Verw. 18 °C | Koel. 18 °C | Wanneer te gebruiken |
|---|---|---|---|
hourly |
781.9 | 1331.6 | Standaard. Integreert het uurlijkse tekort of overschot — fysisch het meest getrouw. |
costic |
741.7 | 1349.5 | Franse DJU unifiés. Vereist door Franse energieprestatiecontracten. |
mean |
659.9 | 1267.8 | Daggemiddelde tegen de basis. De meest verbreide internationale conventie. |
eurostat |
587.7 | 656.6 | Europese statistiek. De bases liggen vast in de definitie en negeren base. |
Dezelfde gegevens, dezelfde basis, hetzelfde jaar, dezelfde plaats — en 18 % verschil tussen de eerste en de derde regel. Wie u „de graaddagen” overhandigt zonder de methode te noemen, heeft u een getal gegeven dat u niet kunt aansluiten. /v1/degree-days/compare-methods geeft alle vier tegelijk, zodat u degene vindt die de cijfers in uw contract reproduceert voordat u zich op een abonnement vastlegt.
Vier beslissingen die op uw facturen zichtbaar worden
Kalender
Lokale dagen, geen UTC-dagen
Een graaddag is een eigenschap van een kalenderdag daar waar het gebouw staat. Groeperen op UTC schuift een plak van elke nacht de verkeerde dag in en vertekent stilletjes de maandtotalen. Elke aanvraag neemt de tijdverschuiving van de locatie en groepeert daarnaar; de stadseindpunten kennen hun eigen tijdzone.
Steden
Het stedelijk hitte-eiland, gekalibreerd
De heranalyse onderschat bebouwd gebied met 1–3 °C, wat de koelgraaddagen te laag maakt — bepalend als u koeling dimensioneert. De stadseindpunten passen een verschuiving toe die tegen echte stationswaarnemingen is gemeten: Algiers +0,48 °C, Parijs +1,13 °C.
Coördinaateindpunten passen die niet toe, en zeggen dat ook.
Perioden
Dag, week, maand, jaar
Alle vier in dezelfde aanvraag, omdat contracten zich op verschillende vastleggen. Weken zijn ISO-weken, dus 1 januari 2023 wordt in week 52 van 2022 gerapporteerd — wat uw spreadsheet ook zal doen. Elke emmer draagt zijn aantal dagen, zodat een gedeeltelijke maand aan de rand van een bereik zichtbaar is in plaats van stilletjes te kort.
Kwaliteit
De dekking, en wat voorlopig is
Elk antwoord draagt een quality-blok: aanwezige uren, dekking onder 1.0 zodra er uren ontbreken, en een telling van provisional_days die uit de verwachting zijn gevuld in plaats van uit de definitieve heranalyse — ERA5-Land verschijnt met ongeveer vijf dagen vertraging. U ziet precies welk deel van een totaal nog niet definitief is.
Eén aanvraag, tien jaar, één getal
# Parijs, Britse basis 15,5 °C, tien jaar, maandregels
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"
# Hetzelfde gebouw, met de methode die zijn contract noemt
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
# Een portefeuille weercorrigeren: zelfde basis, zelfde methode, veel locaties
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)
# verbruik +9 %, graaddagen +11 % -> het gebouw is verbeterd{
"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 } ]
}# Voeg format=csv toe aan elke aanvraag. Alleen betaalde abonnementen.
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
# Het bestand draagt plaats en datums in de naam, dus het blijft
# zes maanden later in een downloadmap herkenbaar.Wie dit koopt, en waarvoor
Energieprestatiecontracten
Het jaar afsluiten zonder ruzie over het weer
Een contract met gegarandeerde besparing moet „het gebouw is beter geworden” scheiden van „de winter was zacht”. Graaddagen op de basis en de methode van het contract zijn hoe die scheiding wordt vastgelegd — en method=costic is wat een Frans contract zal noemen.
Portefeuillebeheer
400 gebouwen in 12 landen vergelijken
Elke locatie krijgt haar eigen lokale kalender, haar eigen rastercel en, in steden, haar eigen hitte-eilandcorrectie — op één basis en één methode, zodat de vergelijking iets betekent. Geen stationsdekking die u eerst moet nagaan.
Hvac-dimensionering
Koellast tegen een echt koelklimaat
Koelgraaddagen op de basis waarop de installatie werkelijk balanceert, in het stadscentrum in plaats van op de luchthaven waar het heranalyseraster het koelst is. 76 jaar ervan, zodat een ontwerpjaar wordt gekozen in plaats van aangenomen.
Softwareleveranciers
Graaddagen in uw eigen product meeleveren
Commerciële herverspreiding is toegestaan. Zet de getallen in uw energiemanagementplatform, uw facturatiemotor of uw ESG-rapport; één regel bronvermelding is de enige verplichting die u volgt.
Waar de getallen vandaan komen
ERA5-Land, de Copernicus-heranalyse. Een fysisch model dat achterwaarts over elke ooit geassimileerde waarneming is gedraaid en een uurlijks temperatuurveld op een raster van 9 km oplevert, overal op het land, van 1950 tot ongeveer vijf dagen geleden.
Waarom dat een stationsreeks verslaat voor deze taak. Een weerstation draagt elke verplaatsing, elke instrumentwissel en elk gat in zijn geschiedenis met zich mee, dus een dertigjarige trend uit één station is deels een trend in de meetapparatuur. Een heranalyse heeft daar niets van. Ze heeft ook geen dekkingsgaten: een locatie op 60 km van het dichtstbijzijnde station wordt precies zo goed bediend als een locatie naast een luchthaven.
Waar ze zwakker is. Stadscentra, die de heranalyse onderschat — vandaar de gekalibreerde correctie op de stadseindpunten. En de laatste vijf dagen, die voorlopig blijven tot de definitieve heranalyse binnenkomt; het antwoord telt die dagen voor u.
De licentie, en daar gaat het om. Copernicus publiceert ERA5-Land onder CC-BY-4.0: commercieel gebruik, herverspreiding en afgeleide werken zijn uitdrukkelijk toegestaan. Dat maakt hier een product van in plaats van een onderzoeksdownload.
Veelgestelde vragen
Wat is een graaddag precies?
Een maat voor hoe ver, en hoe lang, de buitentemperatuur onder of boven een referentie lag die de basis heet. Graaddagen voor verwarming stapelen zich op als het kouder is dan de basis, die voor koeling als het warmer is.
Ze zijn de standaardmanier om uit te leggen waarom een gebouw deze januari meer verbruikte dan vorige, zonder weer en gedrag door elkaar te halen.
Mag ik elke basistemperatuur gebruiken?
Elke waarde, decimalen inbegrepen. Benoemde presets worden ook geaccepteerd: uk (15,5 °C), ashrae (18,333 °C, oftewel 65 °F), iso, france en eurostat (18 °C).
Verschillende bases voor verwarmen en koelen kunnen in dezelfde aanvraag, omdat een gebouw zelden in beide richtingen op hetzelfde punt balanceert.
Ondersteunt u DJU unifiés / Costic?
Ja — method=costic. Die gebruikt alleen het dagminimum en -maximum met een empirische weging voor dagen die over de basis heen liggen, en daar leggen Franse energieprestatiecontracten zich op vast.
Draai /v1/degree-days/compare-methods over een periode waarvan u al cijfers hebt. Reproduceert Costic ze, gebruik dan Costic. Die controle kost één aanvraag en voorkomt de discussie.
Hoe ver gaat het archief terug?
Tot 1 januari 1950 — 76 jaar, uurlijks, wereldwijd op het land, op een raster van 9 km. Eén aanvraag mag maximaal 10 jaar beslaan; langere reeksen zijn meerdere aanvragen.
Heb ik een weerstation in de buurt nodig?
Nee. Heranalyse op raster dekt elke locatie op het land, ook die zonder station binnen 60 km. Dat is haar belangrijkste voordeel boven graaddagenleveranciers op stationsbasis, samen met het ontbreken van instrumentwissels en gaten in de geschiedenis.
Kan ik naar CSV of Excel exporteren?
Voeg format=csv toe aan elke graaddagenaanvraag op een betaald abonnement. U krijgt de geaggregeerde regels — nooit de uurreeks — met dezelfde maximale spanne als de JSON-aanroep, tegen vier keer de credits.
Die grens is bewust en niet met tegenzin: het archief is waarvoor u betaalt, en een onbegrensde export is de manier waarop een concurrent het in één middag verwerft. De grens is wat het formaat überhaupt laat bestaan.
Wat kost het?
Graaddagen zitten vanaf het Starter-abonnement van € 19 per maand inbegrepen: 50.000 credits, weer inbegrepen, CSV inbegrepen. Een graaddagenaanvraag kost twee credits tot een jaar, plus één per extra jaar.
Bij 50.000 credits zijn dat ruwweg 25.000 opvragingen van één jaar per maand — genoeg voor een portefeuille van een paar honderd gebouwen die dagelijks wordt bevraagd.
Mag ik de waarden in mijn eigen product doorverkopen?
Ja. ERA5-Land verschijnt onder CC-BY-4.0, wat commercieel gebruik, herverspreiding en afgeleide werken toestaat. Toon een regel bronvermelding overal waar de gegevens verschijnen — /v1/attribution geeft de exacte formulering en vraagt geen sleutel.
Toets het aan cijfers die u al hebt
Neem een jaar waarvan de cijfers zijn goedgekeurd, draai compare-methods en kijk welke methode ze reproduceert. Dat is de eerlijke manier om dit te kopen.