Referencia de la API
Tres API con una sola clave. Empiece por la primera tarjeta si aún no ha hecho ninguna llamada; las otras tres son la referencia de endpoints, separada por producto para que cada una siga siendo consultable por sí sola.
URL base. Meteorología y Clima se sirven desde https://api.climatememory.com, y Grados-día desde https://api.climatememory.com. Autentíquese con una cabecera X-API-Key en cada solicitud; todos los endpoints son GET.
Empezar
Haga su primera llamada a la API de Climate Memory en menos de un minuto: obtener una clave, autenticarse, entender los créditos y los límites de ritmo, y tratar los errores. Meteorología, grados-día y clima con una sola clave.
11 secciones →API de Meteorología
Referencia completa de la API de Meteorología: predicción y condiciones actuales para cualquier coordenada o ciudad, cada campo con su unidad, la cascada de modelos de 1,3 km a 28 km, más conjuntos, calidad del aire, nieve, estado del mar y ríos.
10 secciones →API de Grados-día
Referencia completa de la API de Grados-día: grados-día de calefacción y de refrigeración desde ERA5-Land hasta 1950, cualquier temperatura base, cuatro métodos de cálculo incluido el estándar francés Costic, exportación CSV y el archivo horario.
12 secciones →API de Clima
Referencia completa de la API de Clima: 87 años de clima diario para cada punto terrestre del planeta desde 1940, agregados mensuales, normales OMM 1991–2020 y 1961–1990, récords, tendencias de calentamiento y Köppen-Geiger, sobre la malla ERA5.
6 secciones →Todos los endpoints
Una sola tabla, todas las rutas de ambos hosts, con lo que cuestan y dónde están documentadas. Ctrl+F aquí, o pulse / para la paleta de búsqueda.
| Ruta | Función | Scope | Créditos | Documentado en | Host |
|---|---|---|---|---|---|
/v1/geocode | Resolver un nombre de lugar a coordenadas, altitud y huso horario. | cualquier clave | 0 | Geocodificado | api.climatememory.com |
/v1/cities/search | Búsqueda por nombre antigua. Solo compara el nombre ASCII, ordena por población. | cualquier clave | 0 | Búsqueda de ciudad | api.climatememory.com |
/v1/cities/nearest | La ciudad catalogada más cercana a una coordenada. | cualquier clave | 0 | Búsqueda de ciudad | api.climatememory.com |
/v1/attribution | El texto exacto requerido, legible por máquina. No requiere clave. | — | 0 | Atribución y licencias | api.climatememory.com |
/v1/licensing | La tabla de licencias que hay detrás de cada conjunto de datos. No requiere clave. | — | 0 | Atribución y licencias | api.climatememory.com |
/v1/forecast | Predicción horaria y diaria para una coordenada cualquiera. | meteo | 1 | Predicción | api.climatememory.com |
/v1/forecast/city/{country}/{slug} | La misma respuesta, resuelta a través del catálogo de ciudades. | meteo | 1 | Predicción por ciudad | api.climatememory.com |
/v1/current | Las condiciones en este instante para una coordenada, interpoladas entre dos pasos del modelo. | meteo | 1 | Condiciones actuales | api.climatememory.com |
/v1/current/city/{country}/{slug} | Lo mismo, a través del catálogo de ciudades. | meteo | 1 | Condiciones actuales | api.climatememory.com |
/v1/fields | La misma tabla en JSON, con unidades y qué campos vienen por defecto. No requiere clave. | — | 0 | Referencia de campos | api.climatememory.com |
/v1/models | Qué modelos están operativos, qué cubre cada uno y cómo de fresco es cada uno. No requiere clave. | — | 0 | Modelos y resolución | api.climatememory.com |
/v1/probability | Percentiles y probabilidades de lluvia del conjunto del ECMWF de 51 miembros. | meteo | 1 | Probabilidades de conjunto | api.climatememory.com |
/v1/air-quality | Partículas, ozono, NO₂, SO₂, CO y polvo sahariano, desde Copernicus CAMS. | meteo | 1 | Calidad del aire | api.climatememory.com |
/v1/marine | Altura, dirección y periodo de las olas del modelo de oleaje del ECMWF, en todo el mundo, hasta 10 días. | meteo | 1 | Mar — estado del mar | api.climatememory.com |
/v1/hydrology | Caudal de los ríos desde Copernicus GloFAS sobre una red fluvial a 0,05°, hasta 10 días. | meteo | 1 | Ríos | api.climatememory.com |
/v1/degree-days | Grados-día de calefacción y de refrigeración para una coordenada. | dju | 2, +1 por cada periodo completo de 365,25 días del intervalo | Grados-día | api.climatememory.com |
/v1/degree-days?base=15,15.5,18,18.5,20 | Hasta 60 temperaturas base en una sola llamada, al precio de una. | dju | same as one base | Varias bases, una solicitud, un solo precio | api.climatememory.com |
/v1/degree-days/compare-methods | Los cuatro métodos sobre el mismo periodo, uno al lado del otro. | dju | 2, +1 por cada periodo completo de 365,25 días del intervalo | Métodos de cálculo | api.climatememory.com |
/v1/methods | Las definiciones de los métodos y sus preajustes. No requiere clave. | — | 0 | Métodos de cálculo | api.climatememory.com |
/v1/degree-days/city/{country}/{slug} | Lo mismo, con el huso horario de la ciudad y su corrección por isla de calor urbana. | dju | 2, +1 por cada periodo completo de 365,25 días del intervalo | Grados-día por ciudad | api.climatememory.com |
/v1/degree-days?elevation={metres} | Corrección por gradiente térmico desde la altitud de la celda hasta la suya. | dju | same | Grados-día para su edificio, no para la celda de la malla | api.climatememory.com |
/v1/cells/resolve | Qué celda respondería por un punto, y a qué distancia está. | dju | 1 | Fijar una celda para que una línea de base siga siendo comparable | api.climatememory.com |
/v1/degree-days/cell/{cell_id} | Grados-día para una celda nombrada — nunca una búsqueda de la celda más próxima. | dju | 2, +1 por cada periodo completo de 365,25 días del intervalo | Fijar una celda para que una línea de base siga siendo comparable | api.climatememory.com |
/v1/degree-days?breakdown={daily|weekly|monthly|yearly} | Agregar la misma solicitud al periodo sobre el que se liquida su contrato. | dju | same | Periodos de desglose | api.climatememory.com |
/v1/degree-days/monthly | Doce totales mensuales de un año natural, sin serie diaria. | dju | 2 | Totales mensuales de un año | api.climatememory.com |
/v1/coverage | Qué contiene el archivo: primer y último día con datos, y el eje hacia el que crecerá. No requiere clave. | — | 0 | Totales mensuales de un año | api.climatememory.com |
/v1/degree-days?format=csv | Las filas del desglose como archivo CSV. Solo planes de pago. | dju | 4× the JSON call | Exportación CSV | api.climatememory.com |
/v1/historical | El archivo de reanálisis servido en bruto: meteorología horaria hasta 1950. | dju | (years + 1) × (variables ÷ 2), rounded down, min 1 | Histórico horario | api.climatememory.com |
/v1/historical/city/{country}/{slug} | Idéntico, con el huso horario de la ciudad y su corrección por isla de calor. | dju | (years + 1) × (variables ÷ 2), rounded down, min 1 | Histórico por ciudad | api.climatememory.com |
/v1/historical/variables | Qué contiene actualmente el archivo, con unidades, y qué campos son derivados. No requiere clave. | — | 0 | Variables disponibles | api.climatememory.com |
/v1/climate/daily | Trece campos diarios para cualquier coordenada terrestre, de 1940 a la semana pasada. | climate | 2, +1 por cada periodo completo de 365,25 días del intervalo | Clima diario | api.climatememory.com |
/v1/climate/monthly | Los mismos campos agregados por mes natural. | climate | 2, +1 por cada periodo completo de 365,25 días del intervalo | Agregados mensuales | api.climatememory.com |
/v1/climate/summary | Normales mensuales, serie anual, récords, tendencias y Köppen — sin límite de intervalo. | climate | 3, +1 por cada periodo completo de 365,25 días del intervalo | El clima de un lugar, en una sola llamada | api.climatememory.com |
/v1/climate/normals | Una media treintenal sobre un periodo de referencia OMM. | normals | 3 | Normales OMM | api.climatememory.com |
/v1/climate/normals/compare | Ambos periodos OMM y la variación entre ellos, en una sola llamada. | normals | 6 | Comparar dos normales | api.climatememory.com |
/v1/climate/coverage | La pasada que se está sirviendo y las fechas que abarca. No requiere clave. | — | 1 | Cobertura, campos y celdas | api.climatememory.com |
/v1/climate/fields | A qué puede responder esta pasada, con unidades, y qué campos son derivados. No requiere clave. | — | 1 | Cobertura, campos y celdas | api.climatememory.com |
/v1/climate/cells/resolve | Qué celda responde por un punto, y a qué distancia está. | climate | 1 | Cobertura, campos y celdas | api.climatememory.com |
/v1/climate/licensing | Las condiciones de licencia de este archivo. No requiere clave. | — | 0 | Cobertura, campos y celdas | api.climatememory.com |
Para agentes y asistentes de código
Dos archivos, generados desde la misma fuente que estas páginas, de modo que no pueden desviarse de lo que usted está leyendo:
- /llms.txt — la orientación breve: a qué responde cada producto y cuándo recurrir a cuál.
- /llms-full.txt — toda esta referencia en un único archivo Markdown, con cada endpoint, parámetro y advertencia.
Cada servicio publica además un esquema OpenAPI 3.1 y una interfaz navegable: /v1/openapi-weather.json y /v1/docs/weather, /v1/openapi-degree-days.json y /v1/docs/degree-days, /v1/openapi-climate.json y /v1/docs/climate, /v1/openapi-geocoding.json y /v1/docs/geocoding. Genere a partir de ellos un cliente tipado en cualquier lenguaje en lugar de escribirlo a mano.