API Gradi Giorno — GG su qualunque base, dal 1950

Q: Supportate i DJU unifiés / Costic?

Sì — method=costic. Usa solo minimo e massimo giornalieri con una ponderazione empirica per i giorni che scavalcano la base, che è ciò su cui si fissano i contratti francesi di prestazione energetica. Lancia /v1/degree-days/compare-methods su un periodo di cui hai già le cifre. Se Costic le riproduce, usa Costic. Quel controllo costa una richiesta ed evita la discussione.

Q: Posso esportare in CSV o Excel?

Aggiungi format=csv a qualunque richiesta di gradi giorno su un piano a pagamento. Ottieni le righe aggregate — mai la serie oraria — con lo stesso intervallo massimo della chiamata JSON, a quattro volte i crediti. Quel limite è deliberato e non malvolentieri: l'archivio è ciò per cui stai pagando, e un'esportazione senza limiti è il modo in cui un concorrente se lo procura in un pomeriggio. È il limite che permette al formato di esistere.

Sposta la temperatura base

Base °C

18.0

GG risc. / anno

660

GG raffr. / anno

1 267

Algeri · un anno di temperatura media giornaliera Blu fabbisogno di riscaldamento Arancio fabbisogno di raffrescamento

L'area colorata è il grado giorno. Trascina la base e guarda i due totali scambiarsi il posto — quello scambio è tutta la ragione per cui la base deve essere la tua. Questa figura usa il metodo della media giornaliera per poter girare nel tuo browser; l'API integra la serie oraria e riproduce questi totali in base 18.

1950 →

76 anni, orari. Il concorrente specializzato parte dal 2000.

4

Metodi di calcolo, perché decide il tuo contratto, non noi.

9 km

Griglia, ovunque sulle terre emerse — nessuna stazione richiesta vicino.

libera

Temperatura base, decimali compresi, risolta alla richiesta.

Perché i gradi giorno gratuiti sono di solito inutilizzabili

La base

GG18 è la risposta di un solo edificio

Precalcolare i gradi giorno in base 18 è la scorciatoia ovvia, ed è ciò che rende commercialmente inutili la maggior parte dei dataset gratuiti. Un ufficio ben coibentato con apporti interni si equilibra più vicino ai 15 °C; un capannone pieno di spifferi più vicino ai 19. Con una serie GG18, entrambi ricevono un numero che non descrive nessuno dei due.

Noi archiviamo invece la temperatura oraria e facciamo l'integrazione quando chiedi. La base è un parametro della query.

La media

Una media giornaliera nasconde la giornata

Una giornata passata da 8 °C a 22 °C ha una media di 15 °C. Contro una base di 18 sembra una giornata mite con un modesto fabbisogno di riscaldamento. In realtà l'edificio ha scaldato forte tutta la notte e nel pomeriggio non aveva bisogno di niente.

L'integrazione oraria conserva questo. È un numero diverso, ed è quello giusto — a meno che il tuo contratto dica altrimenti, nel qual caso vedi sotto.

Quattro metodi, perché decide il tuo contratto

È il dettaglio che chiude le trattative B2B. La nostra integrazione oraria è la più fedele fisicamente — e inutile per un cliente il cui contratto è scritto su Costic, perché i suoi numeri non torneranno. Quindi il metodo è un parametro.

Metodi dei gradi giorno confrontati sugli stessi dati, Algeri, base 18 °C
method=	GG risc. 18 °C	GG raffr. 18 °C	Quando usarlo
`hourly`	781.9	1331.6	Predefinito. Integra il deficit o l'eccesso orario — il più fedele fisicamente.
`costic`	741.7	1349.5	DJU unifiés francesi. Richiesto dai contratti francesi di prestazione energetica.
`mean`	659.9	1267.8	Media giornaliera contro la base. La convenzione internazionale più diffusa.
`eurostat`	587.7	656.6	Statistica europea. Le basi sono fissate dalla definizione e ignorano `base`.

Stessi dati, stessa base, stesso anno, stesso luogo — e 18 % di scarto tra la prima e la terza riga. Chi ti consegna «i gradi giorno» senza dire con quale metodo ti ha consegnato un numero che non potrai riconciliare. /v1/degree-days/compare-methods restituisce tutti e quattro insieme, così trovi quello che riproduce le cifre già presenti nel tuo contratto prima di impegnarti su un piano.

Quattro decisioni che si vedono nelle tue fatture

Calendario

Giorni locali, non giorni UTC

Un grado giorno è una proprietà di un giorno di calendario dove sta l'edificio. Raggruppare in UTC sposta una fetta di ogni notte nel giorno sbagliato e distorce in silenzio i totali mensili. Ogni richiesta prende lo scostamento del luogo e raggruppa di conseguenza; gli endpoint città conoscono il proprio fuso.

Città

L'isola di calore urbana, calibrata

La rianalisi sottostima le aree edificate di 1–3 °C, il che abbassa i gradi giorno di raffrescamento — determinante se stai dimensionando un condizionamento. Gli endpoint città applicano uno scarto misurato contro osservazioni reali di stazioni: Algeri +0,48 °C, Parigi +1,13 °C.

Gli endpoint per coordinata non lo applicano, e lo dicono.

Periodi

Giornaliero, settimanale, mensile, annuale

Tutti e quattro nella stessa richiesta, perché i contratti si fissano su periodi diversi. Le settimane sono settimane ISO, quindi il 1º gennaio 2023 è riportato nella settimana 52 del 2022 — che è quello che farà anche il tuo foglio di calcolo. Ogni secchio porta il proprio numero di giorni, così un mese parziale al bordo di un intervallo è visibile invece che silenziosamente corto.

Qualità

La copertura, e cosa è provvisorio

Ogni risposta porta un blocco quality: ore presenti, copertura sotto 1.0 quando ne mancano, e un conteggio di provisional_days riempiti dalla previsione invece che dalla rianalisi definitiva — ERA5-Land esce con circa cinque giorni di ritardo. Vedi esattamente quale parte di un totale non è ancora definitiva.

Una richiesta, dieci anni, un numero

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

# Parigi, base britannica di 15,5 °C, dieci anni, righe mensili
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"

# Lo stesso edificio, con il metodo che nomina il suo contratto
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

# Normalizzare un portafoglio sul clima: stessa base, stesso metodo, molti siti
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)
# consumi +9 %, gradi giorno +11 % -> l'edificio è migliorato

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

# Aggiungi format=csv a qualunque richiesta. Solo piani a pagamento.
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

# Il file porta luogo e date nel nome, quindi resta
# identificabile sei mesi dopo in una cartella di download.

Chi compra questo, e per farci cosa

Contratti di prestazione energetica

Chiudere l'anno senza litigare sul meteo

Un contratto a risparmio garantito deve separare «l'edificio è migliorato» da «l'inverno è stato mite». I gradi giorno sulla base e sul metodo del contratto sono il modo in cui quella separazione viene messa per iscritto — e method=costic è ciò che nominerà un contratto francese.

Gestione di portafoglio

Confrontare 400 edifici in 12 paesi

Ogni sito riceve il proprio calendario locale, la propria cella e, in città, la propria correzione dell'isola di calore — su una base e un metodo, così il confronto significa qualcosa. Nessuna copertura di stazioni da verificare prima.

Dimensionamento HVAC

Carico di raffrescamento contro un clima di raffrescamento reale

GG di raffrescamento sulla base a cui l'impianto si equilibra davvero, in centro città e non all'aeroporto dove la maglia di rianalisi è più fresca. 76 anni di dati, così l'anno di progetto si sceglie invece di supporlo.

Fornitori di software

Portare i gradi giorno dentro il tuo prodotto

La redistribuzione commerciale è permessa. Metti i numeri nella tua piattaforma di gestione energetica, nel tuo motore di fatturazione o nel tuo report ESG; una riga di attribuzione è l'unico obbligo che ti segue.

Da dove vengono i numeri

ERA5-Land, la rianalisi Copernicus. Un modello fisico fatto girare all'indietro su ogni osservazione mai assimilata, che produce un campo di temperatura oraria su una griglia di 9 km, ovunque sulle terre emerse, dal 1950 a circa cinque giorni fa.

Perché batte una serie di stazione per questo lavoro. Una stazione meteorologica porta con sé ogni spostamento, ogni cambio di strumento e ogni buco della sua storia, quindi un trend trentennale calcolato da una stazione è in parte un trend della strumentazione. Una rianalisi non ha niente di tutto ciò. Non ha nemmeno buchi di copertura: un sito a 60 km dalla stazione più vicina è servito esattamente bene come uno accanto a un aeroporto.

Dove è più debole. I centri urbani, che la rianalisi sottostima — da cui la correzione calibrata sugli endpoint città. E gli ultimi cinque giorni, provvisori finché non arriva la rianalisi definitiva; la risposta conta quei giorni per te.

La licenza, che è il punto. Copernicus pubblica ERA5-Land con CC-BY-4.0: uso commerciale, redistribuzione e opere derivate esplicitamente permessi. È questo che ne fa un prodotto anziché un download di ricerca.

Domande frequenti

Che cos'è esattamente un grado giorno?

Una misura di quanto, e per quanto tempo, la temperatura esterna è stata sotto o sopra un riferimento chiamato base. I gradi giorno di riscaldamento si accumulano quando fa più freddo della base, quelli di raffrescamento quando fa più caldo.

Sono il modo standard di spiegare perché un edificio ha consumato più energia questo gennaio dello scorso, senza confondere il meteo con il comportamento.

Posso usare qualunque temperatura base?

Qualunque valore, decimali compresi. Sono accettati anche preset con nome: uk (15,5 °C), ashrae (18,333 °C, cioè 65 °F), iso, france ed eurostat (18 °C).

Basi diverse per riscaldamento e raffrescamento sono ammesse nella stessa richiesta, perché un edificio raramente si equilibra allo stesso punto nelle due direzioni.

Supportate i DJU unifiés / Costic?

Sì — method=costic. Usa solo minimo e massimo giornalieri con una ponderazione empirica per i giorni che scavalcano la base, che è ciò su cui si fissano i contratti francesi di prestazione energetica.

Lancia /v1/degree-days/compare-methods su un periodo di cui hai già le cifre. Se Costic le riproduce, usa Costic. Quel controllo costa una richiesta ed evita la discussione.

Fin dove arriva l'archivio?

Al 1º gennaio 1950 — 76 anni, orari, in tutto il mondo sulle terre emerse, su una griglia di 9 km. Una singola richiesta può coprire fino a 10 anni; storici più lunghi sono più richieste.

Serve una stazione meteo vicino al sito?

No. La rianalisi su griglia copre ogni località terrestre, comprese quelle senza stazione entro 60 km. È il suo vantaggio principale sui fornitori di gradi giorno basati su stazioni, insieme all'assenza di cambi di strumento e buchi nella storia.

Posso esportare in CSV o Excel?

Aggiungi format=csv a qualunque richiesta di gradi giorno su un piano a pagamento. Ottieni le righe aggregate — mai la serie oraria — con lo stesso intervallo massimo della chiamata JSON, a quattro volte i crediti.

Quel limite è deliberato e non malvolentieri: l'archivio è ciò per cui stai pagando, e un'esportazione senza limiti è il modo in cui un concorrente se lo procura in un pomeriggio. È il limite che permette al formato di esistere.

Quanto costa?

I gradi giorno sono inclusi dal piano Starter a 19 € al mese: 50.000 crediti, meteo inclusa, CSV incluso. Una richiesta di gradi giorno costa due crediti fino a un anno, più uno per ogni anno aggiuntivo.

Con 50.000 crediti sono circa 25.000 consultazioni di un anno al mese — abbastanza per un portafoglio di qualche centinaio di edifici interrogato ogni giorno.

Prezzi completi →

Posso rivendere i valori dentro il mio prodotto?

Sì. ERA5-Land è pubblicata con CC-BY-4.0, che permette uso commerciale, redistribuzione e opere derivate. Mostra una riga di attribuzione ovunque compaiano i dati — /v1/attribution restituisce la formulazione esatta e non richiede chiave.

Verificala contro cifre che hai già

Prendi un anno di cui hai numeri approvati, lancia compare-methods e guarda quale metodo li riproduce. Questo è il modo onesto di comprare tutto ciò.

Inizia con Starter — 19 € Riferimento gradi giorno

La tua temperatura base. Non la base 18.