API Grade-zile — grade-zile pe orice bază, din 1950

Q: Susțineți DJU unifiés / Costic?

Da — method=costic. Folosește doar minimul și maximul zilnic cu o ponderare empirică pentru zilele care traversează baza, lucru pe care se fixează contractele franceze de performanță energetică. Rulează /v1/degree-days/compare-methods pe o perioadă pentru care ai deja cifre. Dacă Costic le reproduce, folosește Costic. Verificarea costă o cerere și previne discuția.

Q: Pot exporta în CSV sau Excel?

Adaugă format=csv la orice cerere de grade-zile pe un plan plătit. Primești rândurile agregate — niciodată seria orară — cu același interval maxim ca apelul JSON, la de patru ori creditele. Limita e deliberată și nu în silă: arhiva e ceea ce plătești, iar un export fără limită e felul în care un concurent o obține într-o după-amiază. Limita e cea care permite formatului să existe.

Mută temperatura de bază

Bază °C

18.0

Încălzire / an

660

Răcire / an

1 267

Alger · un an de temperatură medie zilnică Albastru necesar de încălzire Portocaliu necesar de răcire

Aria colorată este gradul-zi. Trage baza și privește cum cele două totaluri își schimbă locurile — acel schimb e tot motivul pentru care baza trebuie să fie a ta. Această figură folosește metoda mediei zilnice ca să poată rula în browserul tău; API-ul integrează seria orară și reproduce aceste totaluri pe baza 18.

1950 →

76 de ani, orar. Concurentul specializat pornește din 2000.

4

Metode de calcul, pentru că decide contractul tău, nu noi.

9 km

Grilă, peste tot pe uscat — nu e nevoie de stație în apropiere.

liberă

Temperatura de bază, cu zecimale, rezolvată la cerere.

De ce datele gratuite de grade-zile sunt de obicei inutilizabile

Baza

Baza 18 e răspunsul unei singure clădiri

Precalcularea gradelor-zile pe baza 18 e scurtătura evidentă și e ceea ce face majoritatea seturilor gratuite inutile comercial. Un birou bine izolat cu aporturi interne se echilibrează mai aproape de 15 °C; o hală cu infiltrații mai aproape de 19. Cu o serie pe baza 18, amândouă primesc un număr care nu descrie niciuna.

Noi păstrăm în schimb temperatura orară și facem integrarea când ceri. Baza e un parametru al interogării.

Medierea

O medie zilnică ascunde ziua

O zi care a oscilat de la 8 °C la 22 °C are media 15 °C. Față de o bază de 18 pare o zi blândă cu necesar modest de încălzire. În realitate clădirea a încălzit puternic toată noaptea și după-amiaza nu a mai avut nevoie de nimic.

Integrarea orară păstrează asta. E un număr diferit și e cel corect — dacă nu cumva contractul tău spune altceva, caz în care vezi mai jos.

Patru metode, pentru că decide contractul tău

Acesta e detaliul care închide afaceri B2B. Integrarea noastră orară e cea mai fidelă fizic — și inutilă pentru un client al cărui contract e scris pe Costic, pentru că cifrele lui nu se vor potrivi. Așa că metoda e un parametru.

Metode de grade-zile comparate pe aceleași date, Alger, baza 18 °C
method=	Încălzire 18 °C	Răcire 18 °C	Când se folosește
`hourly`	781.9	1331.6	Implicit. Integrează deficitul sau excesul orar — cea mai fidelă fizic.
`costic`	741.7	1349.5	DJU unifiés franceze. Cerută de contractele franceze de performanță energetică.
`mean`	659.9	1267.8	Media zilnică față de bază. Cea mai răspândită convenție internațională.
`eurostat`	587.7	656.6	Statistica europeană. Bazele sunt fixate de definiție și ignoră `base`.

Aceleași date, aceeași bază, același an, același loc — și 18 % diferență între primul și al treilea rând. Cine îți dă „gradele-zile” fără să spună prin ce metodă ți-a dat un număr pe care nu îl vei putea reconcilia. /v1/degree-days/compare-methods le returnează pe toate patru deodată, ca să găsești metoda care reproduce cifrele deja prezente în contractul tău înainte să te legi de un plan.

Patru decizii care se văd în facturile tale

Calendar

Zile locale, nu zile UTC

Un grad-zi este o proprietate a unei zile calendaristice acolo unde se află clădirea. Gruparea pe UTC mută o felie din fiecare noapte în ziua greșită și denaturează tăcut totalurile lunare. Fiecare cerere ia decalajul locului și grupează în consecință; punctele de acces pe oraș își cunosc propriul fus.

Orașe

Insula de căldură urbană, calibrată

Reanaliza subestimează zonele construite cu 1–3 °C, ceea ce coboară gradele-zile de răcire — determinant dacă dimensionezi un aer condiționat. Punctele de acces pe oraș aplică un decalaj măsurat față de observații reale de stație: Alger +0,48 °C, Paris +1,13 °C.

Punctele de acces pe coordonate nu îl aplică și o spun.

Perioade

Zilnic, săptămânal, lunar, anual

Toate patru în aceeași cerere, pentru că contractele se fixează pe perioade diferite. Săptămânile sunt săptămâni ISO, deci 1 ianuarie 2023 e raportat în săptămâna 52 din 2022 — ceea ce va face și foaia ta de calcul. Fiecare găleată poartă numărul ei de zile, așa că o lună parțială la marginea unui interval e vizibilă în loc să fie tăcut scurtă.

Calitate

Acoperirea și ce e provizoriu

Fiecare răspuns poartă un bloc quality: ore prezente, acoperire sub 1.0 când lipsesc ore, și un număr de provisional_days completate din prognoză în loc de reanaliza finală — ERA5-Land se publică cu circa cinci zile întârziere. Vezi exact ce parte dintr-un total nu e încă definitivă.

O cerere, zece ani, un număr

GET /v1/degree-days?lat=&lon=&base=&method=&start=&end=

# Paris, baza britanică de 15,5 °C, zece ani, rânduri lunare
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"

# Aceeași clădire, cu metoda pe care o numește contractul
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

# Normalizarea climatică a unui portofoliu: aceeași bază, aceeași metodă, multe situri
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)
# consum +9 %, grade-zile +11 % -> clădirea s-a îmbunătățit

{
  "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 } ]
}

# Adaugă format=csv la orice cerere. Doar în planurile plătite.
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

# Fișierul poartă locul și datele în nume, deci rămâne
# identificabil șase luni mai târziu într-un dosar de descărcări.

Cine cumpără asta și pentru ce

Contracte de performanță energetică

Să închizi anul fără ceartă despre vreme

Un contract cu economii garantate trebuie să separe „clădirea s-a îmbunătățit” de „iarna a fost blândă”. Gradele-zile pe baza și metoda proprii contractului sunt felul în care acea separare se pune în scris — iar method=costic e ceea ce va numi un contract francez.

Managementul portofoliului

Să compari 400 de clădiri în 12 țări

Fiecare sit primește propriul calendar local, propria celulă de grilă și, în orașe, propria corecție de insulă de căldură — pe o singură bază și o singură metodă, ca comparația să însemne ceva. Nicio acoperire de stații de verificat în prealabil.

Dimensionare HVAC

Sarcină de răcire față de un climat real de răcire

Grade-zile de răcire pe baza la care echipamentul chiar se echilibrează, în centrul orașului și nu la aeroport, unde grila de reanaliză e cea mai răcoroasă. 76 de ani din ele, ca anul de proiectare să fie ales, nu presupus.

Furnizori de software

Să livrezi gradele-zile în propriul produs

Redistribuirea comercială este permisă. Pune cifrele în platforma ta de management energetic, în motorul de facturare sau în raportul ESG; o linie de atribuire e singura obligație care te urmează.

De unde vin cifrele

ERA5-Land, reanaliza Copernicus. Un model fizic rulat înapoi peste fiecare observație asimilată vreodată, care produce un câmp de temperatură orară pe o grilă de 9 km, peste tot pe uscat, din 1950 până acum circa cinci zile.

De ce bate asta o serie de stație pentru această treabă. O stație meteo poartă fiecare mutare, fiecare schimbare de instrument și fiecare gol din istoria ei, deci o tendință de treizeci de ani calculată dintr-o stație e în parte o tendință a instrumentației. O reanaliză nu are nimic din asta. Nu are nici goluri de acoperire: un sit la 60 km de cea mai apropiată stație e servit exact la fel de bine ca unul de lângă un aeroport.

Unde e mai slabă. Centrele urbane, pe care reanaliza le subestimează — de aici corecția calibrată de pe punctele de acces pe oraș. Și ultimele cinci zile, provizorii până sosește reanaliza finală; răspunsul numără acele zile pentru tine.

Licența, care e miezul problemei. Copernicus publică ERA5-Land sub CC-BY-4.0: uz comercial, redistribuire și opere derivate explicit permise. Asta face din ea un produs, nu o descărcare de cercetare.

Întrebări frecvente

Ce este mai exact un grad-zi?

O măsură a cât de mult, și pentru cât timp, temperatura exterioară a stat sub sau peste o referință numită bază. Gradele-zile de încălzire se acumulează când e mai frig decât baza, cele de răcire când e mai cald.

Sunt modul standard de a explica de ce o clădire a consumat mai multă energie în ianuarie anul acesta decât anul trecut, fără a confunda vremea cu comportamentul.

Pot folosi orice temperatură de bază?

Orice valoare, cu zecimale. Se acceptă și presetări cu nume: uk (15,5 °C), ashrae (18,333 °C, adică 65 °F), iso, france și eurostat (18 °C).

Baze diferite pentru încălzire și răcire sunt acceptate în aceeași cerere, pentru că o clădire rareori se echilibrează în același punct în ambele sensuri.

Susțineți DJU unifiés / Costic?

Da — method=costic. Folosește doar minimul și maximul zilnic cu o ponderare empirică pentru zilele care traversează baza, lucru pe care se fixează contractele franceze de performanță energetică.

Rulează /v1/degree-days/compare-methods pe o perioadă pentru care ai deja cifre. Dacă Costic le reproduce, folosește Costic. Verificarea costă o cerere și previne discuția.

Cât de mult în urmă merge arhiva?

Până la 1 ianuarie 1950 — 76 de ani, orar, în toată lumea pe uscat, pe o grilă de 9 km. O singură cerere poate acoperi până la 10 ani; istorice mai lungi înseamnă mai multe cereri.

Am nevoie de o stație meteo lângă sit?

Nu. Reanaliza pe grilă acoperă orice locație terestră, inclusiv situri fără stație pe o rază de 60 km. Acesta e principalul ei avantaj față de furnizorii de grade-zile bazați pe stații, alături de lipsa schimbărilor de instrument și a golurilor din istoric.

Pot exporta în CSV sau Excel?

Adaugă format=csv la orice cerere de grade-zile pe un plan plătit. Primești rândurile agregate — niciodată seria orară — cu același interval maxim ca apelul JSON, la de patru ori creditele.

Limita e deliberată și nu în silă: arhiva e ceea ce plătești, iar un export fără limită e felul în care un concurent o obține într-o după-amiază. Limita e cea care permite formatului să existe.

Cât costă?

Gradele-zile sunt incluse din planul Starter la 19 € pe lună: 50.000 de credite, vreme inclusă, CSV inclus. O cerere de grade-zile costă două credite până la un an, plus unul pentru fiecare an în plus.

La 50.000 de credite asta înseamnă aproximativ 25.000 de interogări de un an pe lună — suficient pentru un portofoliu de câteva sute de clădiri interogat zilnic.

Prețuri complete →

Pot revinde valorile în propriul produs?

Da. ERA5-Land se publică sub CC-BY-4.0, care permite uz comercial, redistribuire și opere derivate. Afișează o linie de atribuire oriunde apar datele — /v1/attribution returnează formularea exactă și nu cere cheie.

Verifică-l cu cifre pe care le ai deja

Ia un an pentru care ai cifre validate, rulează compare-methods și vezi ce metodă le reproduce. Ăsta e modul onest de a cumpăra așa ceva.

Începe cu Starter — 19 € Referința grade-zile

Temperatura ta de bază. Nu baza 18.