API de Meteorología · 1,3 km a 28 km · 15 días
El modelo más fino que cubre tu punto. Elegido en cada petición.
La mayoría de las API meteorológicas ejecutan un único modelo global en todas partes. Esta guarda 8 y resuelve cuál responde a una coordenada dada en un horizonte dado — de modo que un pueblo alpino no recibe la misma celda de 28 km que el Atlántico abierto.
Los mismos 120 km de costa, tal como los ve cada modelo 28 km la bahía ha desaparecido 1.3 km la isla existe
La resolución no es un detalle de ficha técnica. Decide si una bahía, un valle o una isla existen en el modelo — y una celda que promedia mar y tierra te da la temperatura de ninguna de las dos.
8 modelos, resueltos automáticamente
Nunca eliges modelo. Envías una coordenada; la API toma el más fino que la cubre, mezcla en los bordes de dominio para que el valor no salte, y te dice en la respuesta qué modelo contestó.
| Modelo | Resolución | Cobertura | Pasadas | Horizonte | Disponible tras |
|---|---|---|---|---|---|
| Météo-France AROME | 1.3 km | Francia y alrededores | 8 ×/día | 51 h | 4 h |
| DWD ICON-D2 | 2.2 km | Europa central | 4 ×/día | 48 h | 2 h |
| NOAA HRRR | 3 km | EE. UU. continental | 4 ×/día | 48 h | 1.5 h |
| DWD ICON-EU | 6.5 km | Europa, norte de África, Próximo Oriente | 2 ×/día | 120 h | 3 h |
| DWD ICON | 13 km | Mundo | 2 ×/día | 180 h | 4 h |
| ECMWF IFS | 28 km | Mundo — siempre presente | 2 ×/día | 240 h | 7 h |
| ECMWF AIFS | 28 km | Mundo, días 11–15 | 2 ×/día | 360 h | 7 h |
| ECMWF wave | 28 km | Solo océanos y mares | 2 ×/día | 240 h | 7 h |
Bordes de dominio
Ninguna costura donde un modelo se acaba
Cambiar de modelo de golpe en una frontera hace que dos pueblos vecinos discrepen sin razón física. Cada dominio lleva un margen de mezcla: cerca del borde el peso del modelo fino decae y el resto pasa al siguiente. Dentro del dominio tienes el modelo fino sin mezcla.
Horizonte
Fino al principio, global después
AROME se para a las 51 horas y HRRR a las 48. Más allá, el resolutor baja por ICON-EU e ICON hasta ECMWF, en la misma petición. Tu serie de siete días está cosida con el mejor modelo en cada paso, y la respuesta registra la mezcla.
Lo que vuelve
45 campos horarios — 27 almacenados, 18 calculados al vuelo. 21 vuelven por defecto; nombra los demás en hourly=, o nombra menos y reduce la respuesta.
Temperatura y humedad
temperature_2m, máximas y mínimas diarias, dewpoint_2m, humedad relativa, sensación térmica, índice de calor, sensación de frío por viento, temperatura de superficie.
Viento
Componentes u/v a 10 m y 100 m para el mercado eólico, velocidad, dirección, punto cardinal, fuerza Beaufort y wind_gust_10m.
Precipitación
Precipitación total decumulada por intervalo, nieve como equivalente en agua, y un código OMM precipitation_type que separa lluvia, nieve y lluvia engelante.
Nubosidad y visibilidad
Cobertura total más baja, media y alta por separado — la nube baja es la que vuelve gris el día, el cirro apenas atenúa el sol. Octas para aviación y visibility para la niebla.
Radiación y sol
Irradiancia de onda corta, separada en directa y difusa para el rendimiento fotovoltaico. Elevación y acimut del sol, indicador de día, orto y ocaso, e índice UV estimado.
Presión e inestabilidad
Presión a nivel del mar y en superficie, tendencia de tres horas, cape para el potencial convectivo y vapor de agua integrado en la columna.
Suelo
Temperatura del suelo en superficie y en la zona radicular 7–28 cm — la que le importa a la agricultura — desde ICON. soil_temperature_0cm y soil_temperature_8cm.
Nieve
Espesor, equivalente en agua, isocero y snow_line_altitude — la altitud por encima de la cual la precipitación cae en forma de nieve, que es una decisión sobre la que una autoridad de carreteras puede actuar.
Resumen
Un único weather_code OMM por paso de tiempo, para que el cliente dibuje un icono en lugar de reimplementar la lógica que convierte siete campos en «lluvia débil».
Dos correcciones que la mayoría de las API se salta
Altitud
La montaña del modelo no es tu montaña
Un modelo numérico suaviza el relieve a su malla. Un pueblo de fondo de valle puede estar 400 m por debajo de la altitud que el modelo le atribuye, y la temperatura bruta está equivocada en el gradiente térmico de esa diferencia.
Envía elevation con tu petición y el valor se corrige contra la orografía del propio modelo. En zonas de relieve eso vale típicamente 1–3 °C. La respuesta indica la altitud del modelo, la tuya y el ajuste aplicado — puedes auditarlo o ignorarlo.
Frescura
Caducado gana a ausente, y lo dice
Si nuestra pasada más reciente es más vieja de lo esperado, sigues recibiendo datos, con "stale": true y data_age_hours en el bloque source. Una previsión de ocho horas es más útil para tus usuarios que un error 500.
Lo que nunca obtienes es un número caducado con aspecto de fresco. Decide en tu propio código si mostrarlo, avisar o recurrir a otra cosa.
{
"grid": { "distance_km": 8.04, "resolution_km": 28.0 },
"elevation": {
"applied": true,
"model_elevation_m": 91.0,
"location_elevation_m": 113,
"temperature_offset_c": -0.14
},
"source": {
"model": "ecmwf_ifs",
"model_run": "20260725T00Z",
"data_age_hours": 8.95,
"stale": false,
"attribution": "Data: ECMWF (CC-BY-4.0)"
}
}Con la misma clave, no con otra factura
Cuatro cosas que en otros sitios suelen ser productos aparte. Aquí son puntos de entrada del plan que ya has comprado.
/v1/probability
¿Cómo de segura es la previsión?
Un valor único dice 22 °C el jueves — una conjetura presentada como un hecho. Esto devuelve p10, p50, p90 y la dispersión del conjunto de 50 miembros de ECMWF, más las probabilidades de lluvia a 0,1, 1, 5 y 10 mm.
Una dispersión de 0,4 °C es una situación asentada. Una dispersión de 3 °C significa que la atmósfera misma es incierta, y tus usuarios merecen que se lo digan.
/v1/air-quality
Partículas, ozono, NO₂ — y polvo sahariano
De Copernicus CAMS, con los valores guía de la OMS incluidos en cada respuesta para poder situar un número sin ir a buscarlo.
El polvo importa en el norte de África y el Mediterráneo: un episodio lleva las PM10 por encima de mil µg/m³ durante días, y los servicios gratuitos lo cubren mal.
/v1/marine
Estado de la mar en todo el mundo
Altura significativa de ola, dirección y periodo del modelo de oleaje de ECMWF, hasta diez días. Un punto en tierra devuelve 404 not_at_sea en vez de una columna de nulos que parece una avería.
/v1/hydrology
Cuánta agua llega aquí
Caudal fluvial de Copernicus GloFAS sobre una red de ríos de 0,05° — no cuánta lluvia cae aguas arriba, sino cuánta agua llega a este punto, cosa que separan una cuenca y un día de recorrido.
Solo informativo. Emitir avisos de crecida está reservado a las autoridades nacionales y regionales.
Dónde se pone a trabajar
Productos meteorológicos
Páginas de ciudad, aplicaciones y widgets. Un código OMM por paso para el icono, agregados diarios cortados en el huso del usuario y un catálogo de ciudades con búsqueda y punto más cercano.
Energía
Viento a 100 m para la altura de buje, irradiancia directa y difusa para el rendimiento fotovoltaico y dispersión de conjunto para el lado de riesgo de una posición.
Agricultura
Temperatura y temperatura del suelo a cuatro profundidades, entradas de evapotranspiración, riesgo de helada desde la temperatura mínima y rachas para ventanas de tratamiento.
Logística y carreteras
Cota de nieve, isocero, tipo de precipitación y visibilidad — los cuatro campos que deciden si se cierra un puerto de montaña.
Náutica y aire libre
Altura, periodo y dirección de ola, rachas de viento, índice UV y horas de luz para la planificación que hay que hacer con una semana de antelación.
Revendedores
Puedes redistribuir. Construye un producto encima y véndelo, con una línea de atribución al pie como única obligación que te sigue.
Lo que hace mal
Preferimos que conozcas los límites ahora a que los descubras en producción.
Fuerte
Temperatura, presión, viento sinóptico, humedad, insolación. El error típico de la temperatura a 2 m a 24 horas ronda 1–1,5 °C. ECMWF es el mejor modelo determinista global del mundo, y es lo que recibes.
Débil
Tormentas convectivas — una celda de 28 km no resuelve una tormenta, y ni siquiera 3 km hacen más que insinuarla. Ubicación y hora exactas de los chubascos. Microclima costero y de montaña por debajo de la resolución del modelo. Brisas marinas y embolsamientos de aire frío en valles, que la corrección de altitud no modela.
Honestidad geográfica
En Francia, Alemania, Estados Unidos y Canadá servimos modelos nacionales de 1,3–3 km y un pueblo pequeño tiene de verdad su propia celda. Los territorios de ultramar, Alaska, Hawái y el norte de Canadá quedan fuera de esos dominios y caen a 13 km. En el resto de Europa tienes 6,5 km. En África, Oriente Próximo y buena parte de Asia el mejor modelo público disponible es de 13–28 km: obtienes el tiempo de la zona más que el de la calle. La corrección de altitud reduce esa brecha; no la cierra.
No es un servicio de avisos
Sin alertas, sin colores de nivel, sin instrucciones de actuación. Eso pertenece a las autoridades, que además pueden cortar una carretera y evacuar un pueblo.
Preguntas frecuentes
¿Qué modelo servirá mi ubicación?
El más fino que la cubra: AROME a 1,3 km en Francia, ICON-D2 a 2,2 km en Europa central, HRRR a 3 km en Estados Unidos, ICON-EU a 6,5 km en Europa y el norte de África, ICON a 13 km en el mundo, y ECMWF IFS a 28 km como base siempre presente.
Llama a /v1/models para ver el registro actual y el dominio de cada modelo, o lee source.model en cualquier respuesta.
¿Con qué frecuencia se actualiza?
Los modelos globales dos veces al día a las 00 y 12 UTC; los modelos nacionales de alta resolución cuatro veces al día a las 00, 06, 12 y 18 UTC. Los datos son utilizables entre 90 minutos y 7 horas después de la pasada según el proveedor — la tabla de arriba da cada uno.
Las respuestas de previsión se cachean cinco minutos en el borde, lo que absorbe el tráfico repetido de las páginas de ciudad sin servir jamás una pasada anterior a la que tenemos.
¿Puedo pedir muchas ubicaciones a la vez?
Una coordenada por petición. El almacenamiento está troceado de forma que toda la serie temporal de una zona pequeña cabe en un bloque — un punto a lo largo de todos los pasos es la consulta barata, y es la que hace prácticamente cualquier producto.
Para tráfico con forma de ciudad, /v1/forecast/city/{country}/{slug} lleva el huso horario y la altitud de la ciudad, para que no tengas que hacerlo tú.
¿Hay descarga masiva?
No, en ningún plan. 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. La exportación CSV de grados-día existe y está deliberadamente acotada.
¿Cuánto cuesta?
Gratis para 10.000 créditos al mes sin tarjeta. 19 € al mes por 50.000 créditos incluyendo la API de Grados-día, histórico y CSV. 79 € por 400.000 créditos y todo lo demás. Una petición de previsión es un crédito.
Pruébala con tus propias coordenadas
El plan gratuito devuelve los mismos datos que los de pago. Apúntala a un sitio que conozcas bien y juzga tú mismo los números.