API Degrés-jours — DJU sur n'importe quelle base, depuis 1950

Q: Gérez-vous les DJU unifiés / Costic ?

Oui — method=costic. Elle n'utilise que les minimum et maximum quotidiens avec une pondération empirique pour les journées qui chevauchent la base, ce sur quoi se fixent les contrats de performance énergétique français. Lancez /v1/degree-days/compare-methods sur une période dont vous avez déjà les chiffres. Si Costic les reproduit, prenez Costic. Cette vérification coûte une requête et évite la discussion.

Q: Puis-je exporter en CSV ou Excel ?

Ajoutez format=csv à n'importe quelle requête degrés-jours sur une offre payante. Vous obtenez les lignes agrégées — jamais la série horaire — avec la même durée maximale que l'appel JSON, à quatre fois les crédits. Cette borne est délibérée et non pas rechignée : l'archive est ce que vous payez, et un export sans limite est la façon dont un concurrent l'acquiert en un après-midi. C'est la borne qui permet au format d'exister.

Déplacez la base de température

Base °C

18.0

DJC / an

660

DJR / an

1 267

Alger · une année de température moyenne quotidienne Bleu besoin de chauffage Orange besoin de climatisation

L'aire colorée est le degré-jour. Déplacez la base et regardez les deux totaux échanger leurs places — cet échange est toute la raison pour laquelle la base doit être la vôtre. Cette figure utilise la méthode moyenne quotidienne pour tourner dans votre navigateur ; l'API intègre la série horaire, et reproduit ces totaux en base 18.

1950 →

76 ans, au pas horaire. Le concurrent spécialiste démarre en 2000.

4

Méthodes de calcul, parce que c'est votre contrat qui décide, pas nous.

9 km

Maille, partout sur les terres — aucune station requise à proximité.

libre

Base de température, décimales comprises, résolue à la requête.

Pourquoi les degrés-jours gratuits sont généralement inutilisables

La base

Le DJU18 est la réponse d'un seul bâtiment

Pré-calculer les degrés-jours en base 18 est le raccourci évident, et c'est ce qui rend la plupart des jeux de données gratuits commercialement inutilisables. Un bureau bien isolé avec des apports internes s'équilibre plutôt vers 15 °C ; un entrepôt mal étanche plutôt vers 19. Avec une série DJU18, les deux reçoivent un chiffre qui ne décrit ni l'un ni l'autre.

Nous stockons la température horaire à la place, et faisons l'intégration quand vous demandez. La base est un paramètre de requête.

Le moyennage

Une moyenne quotidienne cache la journée

Une journée qui est passée de 8 °C à 22 °C a une moyenne de 15 °C. Contre une base de 18, cela ressemble à une journée douce avec un besoin de chauffage modeste. En réalité le bâtiment a chauffé fort toute la nuit et n'avait plus besoin de rien l'après-midi.

L'intégration horaire conserve cela. C'est un chiffre différent, et c'est le bon — sauf si votre contrat dit autre chose, auquel cas voyez plus bas.

Quatre méthodes, parce que c'est votre contrat qui décide

C'est le détail qui conclut les affaires B2B. Notre intégration horaire est la plus fidèle physiquement — et inutile à un client dont le contrat est écrit sur Costic, parce que ses chiffres ne correspondront pas. La méthode est donc un paramètre.

Méthodes de degrés-jours comparées sur les mêmes données, Alger, base 18 °C
method=	DJC 18 °C	DJR 18 °C	Quand l'utiliser
`hourly`	781.9	1331.6	Par défaut. Intègre le déficit ou l'excès horaire — la plus fidèle physiquement.
`costic`	741.7	1349.5	DJU unifiés français. Exigée par les contrats de performance énergétique français.
`mean`	659.9	1267.8	Moyenne quotidienne contre la base. La convention internationale la plus répandue.
`eurostat`	587.7	656.6	Statistiques européennes. Les bases sont fixées par la définition et ignorent `base`.

Mêmes données, même base, même année, même lieu — et 18 % d'écart entre la première et la troisième ligne. Quiconque vous remet « les degrés-jours » sans dire quelle méthode vous a remis un chiffre que vous ne pourrez pas réconcilier. /v1/degree-days/compare-methods renvoie les quatre d'un coup : vous trouvez celle qui reproduit les chiffres déjà présents dans votre contrat avant de vous engager sur une offre.

Quatre décisions qui se voient dans vos factures

Calendrier

Des journées locales, pas des journées UTC

Un degré-jour est une propriété d'une journée civile là où se trouve le bâtiment. Regrouper en UTC déplace une tranche de chaque nuit dans le mauvais jour et biaise discrètement les totaux mensuels. Chaque requête prend le décalage du lieu et regroupe en conséquence ; les points d'entrée ville connaissent leur propre fuseau.

Villes

L'îlot de chaleur urbain, calibré

La réanalyse sous-estime les zones bâties de 1 à 3 °C, ce qui tire les degrés-jours de climatisation vers le bas — déterminant si vous dimensionnez une climatisation. Les points d'entrée ville appliquent un écart mesuré contre de vraies observations de stations : Alger +0,48 °C, Paris +1,13 °C.

Les points d'entrée par coordonnée ne l'appliquent pas, et le disent.

Périodes

Jour, semaine, mois, année

Les quatre sur la même requête, parce que les contrats se fixent sur des périodes différentes. Les semaines sont des semaines ISO : le 1er janvier 2023 est rapporté en semaine 52 de 2022 — ce que votre tableur fera aussi. Chaque bucket porte son nombre de jours, donc un mois partiel en bord de plage est visible plutôt que silencieusement incomplet.

Qualité

La couverture, et ce qui est provisoire

Chaque réponse porte un bloc quality : heures présentes, couverture inférieure à 1.0 dès qu'il en manque, et un décompte de provisional_days remplis depuis la prévision plutôt que la réanalyse définitive — ERA5-Land publie avec environ cinq jours de latence. Vous voyez exactement quelle part d'un total n'est pas encore définitive.

Une requête, dix ans, un chiffre

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

# Paris, base britannique de 15,5 °C, dix ans, lignes mensuelles
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"

# Le même bâtiment, sur la méthode que nomme son contrat
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

# Corriger un parc du climat : même base, même méthode, plusieurs sites
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)
# conso +9 %, degrés-jours +11 % -> le bâtiment s'est amélioré

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

# Ajoutez format=csv à n'importe quelle requête. Offres payantes seulement.
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

# Le fichier porte le nom du lieu et des dates : il reste
# identifiable six mois plus tard dans un dossier de téléchargements.

Qui achète ça, et pour quoi faire

Contrats de performance énergétique

Solder l'année sans se disputer sur la météo

Un contrat à économies garanties doit séparer « le bâtiment s'est amélioré » de « l'hiver a été doux ». Les degrés-jours sur la base et la méthode du contrat sont la façon dont cette séparation est écrite — et method=costic est ce qu'un contrat français nommera.

Gestion de parc

Comparer 400 bâtiments dans 12 pays

Chaque site reçoit son calendrier local, sa maille et, en ville, sa correction d'îlot de chaleur — sur une seule base et une seule méthode, pour que la comparaison veuille dire quelque chose. Aucune couverture de stations à vérifier d'abord.

Dimensionnement CVC

Une charge de froid contre un vrai climat de froid

Des DJR sur la base à laquelle l'équipement s'équilibre réellement, en centre-ville plutôt qu'à l'aéroport où la maille de réanalyse est la plus fraîche. 76 ans de profondeur : une année de dimensionnement se choisit au lieu de se supposer.

Éditeurs de logiciels

Embarquer les degrés-jours dans votre propre produit

La redistribution commerciale est autorisée. Mettez les chiffres dans votre plateforme de management énergétique, votre moteur de facturation ou votre rapport ESG ; une ligne d'attribution est la seule obligation qui vous suit.

D'où viennent les chiffres

ERA5-Land, la réanalyse Copernicus. Un modèle physique rejoué à rebours sur toutes les observations jamais assimilées, produisant un champ de température horaire sur une maille de 9 km, partout sur les terres, de 1950 à il y a environ cinq jours.

Pourquoi cela bat un relevé de station pour ce travail. Une station météo porte chaque déménagement, chaque changement d'instrument et chaque trou de son historique : une tendance sur trente ans calculée depuis une station est en partie une tendance de l'instrumentation. Une réanalyse n'a rien de tout cela. Elle n'a pas non plus de trous de couverture : un site à 60 km de la station la plus proche est servi exactement aussi bien qu'un site voisin d'un aéroport.

Où elle est plus faible. Les centres-villes, que la réanalyse sous-estime — d'où la correction calibrée sur les points d'entrée ville. Et les cinq derniers jours, provisoires jusqu'à l'arrivée de la réanalyse définitive ; la réponse compte ces jours pour vous.

La licence, qui est tout l'enjeu. Copernicus publie ERA5-Land en CC-BY-4.0 : usage commercial, redistribution et œuvres dérivées explicitement autorisés. C'est ce qui en fait un produit plutôt qu'un téléchargement de recherche.

Questions fréquentes

Qu'est-ce qu'un degré-jour, exactement ?

Une mesure de l'écart, et de sa durée, entre la température extérieure et une référence appelée la base. Les degrés-jours de chauffage s'accumulent quand il fait plus froid que la base, ceux de climatisation quand il fait plus chaud.

C'est la façon standard d'expliquer pourquoi un bâtiment a consommé plus en janvier cette année que l'an dernier, sans confondre la météo et le comportement.

Puis-je utiliser n'importe quelle base de température ?

N'importe quelle valeur, décimales comprises. Des préréglages nommés sont acceptés aussi : uk (15,5 °C), ashrae (18,333 °C, soit 65 °F), iso, france et eurostat (18 °C).

Des bases différentes pour le chauffage et la climatisation sont acceptées sur la même requête, car un bâtiment s'équilibre rarement au même point dans les deux sens.

Gérez-vous les DJU unifiés / Costic ?

Oui — method=costic. Elle n'utilise que les minimum et maximum quotidiens avec une pondération empirique pour les journées qui chevauchent la base, ce sur quoi se fixent les contrats de performance énergétique français.

Lancez /v1/degree-days/compare-methods sur une période dont vous avez déjà les chiffres. Si Costic les reproduit, prenez Costic. Cette vérification coûte une requête et évite la discussion.

Jusqu'où remonte l'archive ?

Au 1er janvier 1950 — 76 ans, au pas horaire, partout sur les terres, sur une maille de 9 km. Une requête unique peut couvrir jusqu'à 10 ans ; au-delà, ce sont plusieurs requêtes.

Faut-il une station météo près du site ?

Non. La réanalyse maillée couvre toutes les localisations terrestres, y compris des sites sans station à moins de 60 km. C'est son principal avantage sur les fournisseurs de degrés-jours adossés à des stations, avec l'absence de changements d'instrument et de trous dans l'historique.

Puis-je exporter en CSV ou Excel ?

Ajoutez format=csv à n'importe quelle requête degrés-jours sur une offre payante. Vous obtenez les lignes agrégées — jamais la série horaire — avec la même durée maximale que l'appel JSON, à quatre fois les crédits.

Cette borne est délibérée et non pas rechignée : l'archive est ce que vous payez, et un export sans limite est la façon dont un concurrent l'acquiert en un après-midi. C'est la borne qui permet au format d'exister.

Combien ça coûte ?

Les degrés-jours sont inclus dès l'offre Starter à 19 € par mois : 50 000 crédits, météo comprise, CSV compris. Une requête degrés-jours coûte deux crédits jusqu'à un an, plus un par année supplémentaire.

À 50 000 crédits, cela fait environ 25 000 consultations d'une année par mois — de quoi suivre un parc de quelques centaines de bâtiments interrogé quotidiennement.

Tarifs complets →

Puis-je revendre les valeurs dans mon propre produit ?

Oui. ERA5-Land est publiée en CC-BY-4.0, qui autorise l'usage commercial, la redistribution et les œuvres dérivées. Affichez une ligne d'attribution partout où les données apparaissent — /v1/attribution renvoie la formulation exacte et ne demande aucune clé.

Vérifiez-la contre des chiffres que vous avez déjà

Prenez une année dont les chiffres sont validés, lancez compare-methods, et voyez quelle méthode les reproduit. C'est la façon honnête d'acheter ceci.

Démarrer sur Starter — 19 € Référence degrés-jours

Votre base de température. Pas la base 18.