API de Grados-día · ERA5-Land 9 km · 1950 →
Tu temperatura base. No la base 18.
Un edificio con punto de equilibrio en 15,5 °C no puede usar una cifra HDD18. Conservamos la temperatura horaria y la integramos contra la base que pidas, en el momento de la petición — que es la diferencia entre un número con el que puedes facturar y un número por el que tendrás que disculparte.
18.0
660
1 267
Argel · un año de temperatura media diaria Azul demanda de calefacción Naranja demanda de refrigeración
El área sombreada es el grado-día. Arrastra la base y mira cómo los dos totales intercambian su sitio — ese intercambio es toda la razón por la que la base tiene que ser la tuya. Esta figura usa el método de media diaria para poder ejecutarse en tu navegador; la API integra la serie horaria y reproduce estos totales en base 18.
1950 →
76 años, por hora. El competidor especializado empieza en 2000.
4
Métodos de cálculo, porque lo decide tu contrato, no nosotros.
9 km
Malla, en toda la superficie terrestre — sin estación cerca.
libre
Temperatura base, decimales incluidos, resuelta en la petición.
Por qué los grados-día gratuitos suelen ser inservibles
La base
HDD18 es la respuesta de un solo edificio
Precalcular grados-día en base 18 es el atajo obvio, y es lo que hace comercialmente inservibles a la mayoría de los conjuntos gratuitos. Una oficina bien aislada con ganancias internas se equilibra más cerca de 15 °C; una nave con infiltraciones, más cerca de 19. Con una serie HDD18, ambas reciben un número que no describe a ninguna.
Nosotros guardamos la temperatura horaria y hacemos la integración cuando lo pides. La base es un parámetro de consulta.
El promediado
Una media diaria esconde el día
Un día que fue de 8 °C a 22 °C tiene una media de 15 °C. Contra una base de 18 parece un día suave con demanda modesta de calefacción. En realidad el edificio calentó fuerte toda la noche y no necesitó nada por la tarde.
Integrar por horas conserva eso. Es un número distinto, y es el correcto — salvo que tu contrato diga otra cosa, en cuyo caso mira más abajo.
Cuatro métodos, porque lo decide tu contrato
Este es el detalle que cierra tratos B2B. Nuestra integración horaria es la más fiel físicamente — e inservible para un cliente cuyo contrato está escrito sobre Costic, porque sus números no cuadrarán. Así que el método es un parámetro.
| method= | HDD 18 °C | CDD 18 °C | Cuándo usarlo |
|---|---|---|---|
hourly |
781.9 | 1331.6 | Por defecto. Integra el déficit o el exceso horario — el más fiel físicamente. |
costic |
741.7 | 1349.5 | DJU unifiés francés. Exigido por los contratos franceses de rendimiento energético. |
mean |
659.9 | 1267.8 | Media diaria contra la base. La convención internacional más extendida. |
eurostat |
587.7 | 656.6 | Estadística europea. Las bases las fija la definición e ignoran base. |
Mismos datos, misma base, mismo año, mismo lugar — y un 18 % de diferencia entre la primera y la tercera fila. Quien te entrega «los grados-día» sin decir con qué método te ha entregado un número que no podrás conciliar. /v1/degree-days/compare-methods devuelve los cuatro de golpe, así encuentras el que reproduce las cifras que ya están en tu contrato antes de comprometerte con un plan.
Cuatro decisiones que se ven en tus facturas
Calendario
Días locales, no días UTC
Un grado-día es una propiedad de un día natural donde está el edificio. Agrupar por UTC mueve un trozo de cada noche al día equivocado y sesga en silencio los totales mensuales. Cada petición toma el desfase del lugar y agrupa en consecuencia; los puntos de entrada por ciudad conocen su propio huso.
Ciudades
La isla de calor urbana, calibrada
El reanálisis subestima las zonas construidas en 1–3 °C, lo que sesga a la baja los grados-día de refrigeración — determinante si estás dimensionando aire acondicionado. Los puntos de entrada por ciudad aplican un ajuste medido contra observaciones reales de estaciones: Argel +0,48 °C, París +1,13 °C.
Los puntos de entrada por coordenada no lo aplican, y lo dicen.
Periodos
Diario, semanal, mensual, anual
Los cuatro en la misma petición, porque los contratos se fijan en periodos distintos. Las semanas son semanas ISO, así que el 1 de enero de 2023 se informa en la semana 52 de 2022 — que es lo que también hará tu hoja de cálculo. Cada cubo lleva su número de días, de modo que un mes parcial en el borde de un rango es visible en vez de quedarse corto en silencio.
Calidad
La cobertura, y qué es provisional
Cada respuesta lleva un bloque quality: horas presentes, cobertura por debajo de 1.0 cuando falta alguna, y un recuento de provisional_days rellenados desde la previsión en lugar del reanálisis definitivo — ERA5-Land se publica con unos cinco días de retraso. Ves exactamente qué parte de un total no es todavía definitiva.
Una petición, diez años, un número
# París, base británica de 15,5 °C, diez años, filas mensuales
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"
# El mismo edificio, con el método que nombra su contrato
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
# Normalizar una cartera por clima: misma base, mismo método, muchos sitios
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)
# consumo +9 %, grados-día +11 % -> el edificio mejoró{
"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 } ]
}# Añade format=csv a cualquier petición. Solo en planes de pago.
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
# El fichero lleva el lugar y las fechas en el nombre, así que sigue
# siendo identificable seis meses después en una carpeta de descargas.Quién compra esto, y para qué
Contratos de rendimiento energético
Cerrar el año sin discutir sobre el tiempo
Un contrato de ahorros garantizados tiene que separar «el edificio ha mejorado» de «el invierno ha sido suave». Los grados-día sobre la base y el método del propio contrato son cómo se escribe esa separación — y method=costic es lo que nombrará un contrato francés.
Gestión de cartera
Comparar 400 edificios en 12 países
Cada sitio recibe su calendario local, su celda de malla y, en ciudad, su corrección de isla de calor — sobre una base y un método, para que la comparación signifique algo. Sin cobertura de estaciones que comprobar antes.
Dimensionado de climatización
Carga de frío contra un clima de frío real
CDD sobre la base a la que el equipo se equilibra de verdad, en el centro de la ciudad y no en el aeropuerto, donde la malla de reanálisis es más fresca. 76 años de ellos, para que el año de diseño se elija en lugar de suponerse.
Proveedores de software
Llevar los grados-día dentro de tu propio producto
La redistribución comercial está permitida. Pon los números en tu plataforma de gestión energética, tu motor de facturación o tu informe ESG; una línea de atribución es la única obligación que te sigue.
De dónde salen los números
ERA5-Land, el reanálisis de Copernicus. Un modelo físico ejecutado hacia atrás sobre todas las observaciones jamás asimiladas, que produce un campo de temperatura horario en una malla de 9 km, en toda la superficie terrestre, desde 1950 hasta hace unos cinco días.
Por qué eso gana a un registro de estación para este trabajo. Una estación meteorológica arrastra cada traslado, cada cambio de instrumento y cada hueco de su historia, así que una tendencia de treinta años calculada desde una estación es en parte una tendencia de la instrumentación. Un reanálisis no tiene nada de eso. Tampoco tiene huecos de cobertura: un emplazamiento a 60 km de la estación más cercana se sirve exactamente igual de bien que uno al lado de un aeropuerto.
Dónde es más débil. Los centros urbanos, que el reanálisis subestima — de ahí la corrección calibrada en los puntos de entrada por ciudad. Y los últimos cinco días, provisionales hasta que llega el reanálisis definitivo; la respuesta cuenta esos días por ti.
La licencia, que es de lo que se trata. Copernicus publica ERA5-Land bajo CC-BY-4.0: uso comercial, redistribución y obras derivadas explícitamente permitidos. Eso es lo que hace de esto un producto y no una descarga de investigación.
Preguntas frecuentes
¿Qué es exactamente un grado-día?
Una medida de cuánto, y durante cuánto tiempo, la temperatura exterior estuvo por debajo o por encima de una referencia llamada base. Los grados-día de calefacción se acumulan cuando hace más frío que la base, los de refrigeración cuando hace más calor.
Son la forma estándar de explicar por qué un edificio consumió más este enero que el anterior sin confundir el tiempo con el comportamiento.
¿Puedo usar cualquier temperatura base?
Cualquier valor, decimales incluidos. También se aceptan preajustes con nombre: uk (15,5 °C), ashrae (18,333 °C, o sea 65 °F), iso, france y eurostat (18 °C).
Se admiten bases distintas para calefacción y refrigeración en la misma petición, porque un edificio rara vez se equilibra en el mismo punto en ambos sentidos.
¿Soportáis DJU unifiés / Costic?
Sí — method=costic. Usa solo el mínimo y el máximo diarios con una ponderación empírica para los días que cruzan la base, que es en lo que se fijan los contratos franceses de rendimiento energético.
Ejecuta /v1/degree-days/compare-methods sobre un periodo del que ya tengas cifras. Si Costic las reproduce, usa Costic. Esa comprobación cuesta una petición y evita la discusión.
¿Hasta dónde llega el archivo?
Al 1 de enero de 1950 — 76 años, horario, en toda la superficie terrestre, en malla de 9 km. Una sola petición puede abarcar hasta 10 años; históricos más largos son varias peticiones.
¿Necesito una estación meteorológica cerca?
No. El reanálisis en malla cubre cualquier ubicación terrestre, incluidas las que no tienen estación en 60 km. Esa es su principal ventaja sobre los proveedores de grados-día basados en estaciones, junto con no tener cambios de instrumento ni huecos en su historia.
¿Puedo exportar a CSV o Excel?
Añade format=csv a cualquier petición de grados-día en un plan de pago. Obtienes las filas agregadas — nunca la serie horaria — con el mismo rango máximo que la llamada JSON, a cuatro veces los créditos.
Ese límite es deliberado y no a regañadientes: el archivo es lo que estás pagando, y una exportación sin límite es la forma en que un competidor lo adquiere en una tarde. El límite es lo que permite que el formato exista.
¿Cuánto cuesta?
Los grados-día se incluyen desde el plan Starter a 19 € al mes: 50.000 créditos, meteorología incluida, CSV incluido. Una petición de grados-día cuesta dos créditos hasta un año, más uno por cada año adicional.
Con 50.000 créditos eso son unas 25.000 consultas de un año al mes — suficiente para una cartera de unos cientos de edificios consultada a diario.
¿Puedo revender los valores dentro de mi producto?
Sí. ERA5-Land se publica bajo CC-BY-4.0, que permite uso comercial, redistribución y obras derivadas. Muestra una línea de atribución allí donde aparezcan los datos — /v1/attribution devuelve la redacción exacta y no necesita clave.
Compruébalo contra cifras que ya tengas
Coge un año con números ya aprobados, ejecuta compare-methods y mira qué método los reproduce. Esa es la forma honesta de comprar esto.