Extending climaemet • climaemet

climaemet provides functions for selected AEMET OpenData API endpoints. However, the package does not cover every endpoint.

get_data_aemet() provides access to any AEMET OpenData API endpoint. Users must parse endpoint-specific results themselves.

library(climaemet)

Retrieve normalized text

Some API endpoints, such as predicciones-normalizadas-texto, return plain text. climaemet does not parse these responses, but you can retrieve them directly:

# Endpoint: today's forecast.

today <- "/api/prediccion/nacional/hoy"

# Retrieve metadata.
knitr::kable(get_metadata_aemet(today))

unidad_generadora	descripcion	periodicidad	formato	copyright	notaLegal
Grupo Funcional de Predicción de Referencia	Predicción general nacional para hoy / mañana / pasado mañana / medio plazo (tercer y cuarto día) / tendencia (del quinto al noveno día)	Disponibilidad. Para hoy, solo se confecciona si hay cambios significativos. Para mañana y pasado mañana diaria a las 15:00 h.o.p.. Para el medio plazo diaria a las 16:00 h.o.p.. La tendencia, diaria a las 18:30 h.o.p.	ascii/txt	© AEMET. Autorizado el uso de la información y su reproducción citando a AEMET como autora de la misma.	https://www.aemet.es/es/nota_legal


# Retrieve data.
pred_today <- get_data_aemet(today)
#> ℹ Response MIME type: "text/plain".
#> → Returning a UTF-8 `character` string.

# Produce a result.

clean <- gsub("\r", "\n", pred_today, fixed = TRUE)
clean <- gsub("\n\n\n", "\n", clean, fixed = TRUE)

cat("<blockquote>", clean, "</blockquote>", sep = "\n")

AGENCIA ESTATAL DE METEOROLOGÍA PREDICCIÓN GENERAL PARA ESPAÑA DÍA 24 DE AGOSTO DE 2026 A LAS 11:39 HORA OFICIAL PREDICCIÓN VÁLIDA PARA EL LUNES 24

A.- FENÓMENOS SIGNIFICATIVOS Precipitaciones localmente fuertes y persistentes en el noroeste y oeste del Sistema Central. Chubascos y tormentas fuertes o muy fuertes, acompañadas de rachas de viento muy fuertes y de granizo, ocasionalmente grande, en el noreste. Probables rachas muy fuertes de viento (superiores a 70 km/h) en Galicia, las mesetas y las zonas de montaña de la mitad norte. Descenso notable de las temperaturas máximas (más de 6 grados) en el oeste de la meseta norte y del sistema Central.

B.- PREDICCIÓN La borrasca situada al oeste de Portugal se aproximará y dejará una jornada inestable en buena parte de la Península y Baleares. Se prevé que los frentes asociados a la borrasca recorran el oeste peninsular y dejen cielos muy nubosos o cubiertos y precipitaciones localmente fuertes y persistentes, especialmente en zonas del noroeste. Por otro lado, en Baleares y en el noreste se esperan cielos nubosos con chubascos y tormentas, que en puntos del tercio noreste peninsular pueden ser fuertes o muy fuertes e ir acompañadas de rachas muy fuertes y de granizo, ocasionalmente grande, y sin descartar la formación de algún tornado. Solo en algunos puntos del centro los cielos estarán poco nubosos o despejados. En Canarias, cielos nubosos en el norte de las islas con alguna precipitación débil en las montañosas.

Es posible la formación de brumas matinales en Galicia, el interior de las regiones del Cantábrico, el alto Ebro y buena parte de los interiores del tercio este.

Las temperaturas máximas bajarán de forma generalizada, incluso notablemente en el oeste de la meseta norte y del sistema Central, salvo en los litorales, en los prelitorales mediterráneos y en los archipiélagos, donde se mantendrán sin cambios o subirán. Se podrán superar los 35 grados en puntos del valle del Ebro, de Mallorca y en los prelitorales del Levante. Las mínimas subirán en el Cantábrico oriental, puntos del suroeste y Canarias y no variarán de forma relevante en el resto.

Se espera un predominio del viento del suroeste o sur en la Península, moderado en general y con intervalos localmente fuertes. Son probables las rachas muy fuertes en Galicia, las mesetas y las zonas de montaña de la mitad norte. En el Levante y Baleares soplará del sudeste, rolando a sudoeste. En el litoral del mar de Alborán, se espera un poniente moderado, sin descartar rachas muy fuertes. En Canarias, el viento del norte rolará a noreste a últimas horas, con intensidad moderada.

Retrieve maps

AEMET also provides maps, usually with the image/gif MIME type. You can retrieve these binary responses directly:

# Map endpoint.
a_map <- "/api/mapasygraficos/analisis"

# Retrieve metadata.
knitr::kable(get_metadata_aemet(a_map))

unidad_generadora	descripción	periodicidad	formato	copyright	notaLegal
Grupo Funcional de Jefes de Turno	Mapas de análisis de frentes en superficie	Dos veces al día, a las 02:00 y 14:00 h.o.p. en invierno y a las 03:00 y 15:00 en verano.	image/gif	© AEMET. Autorizado el uso de la información y su reproducción citando a AEMET como autora de la misma.	https://www.aemet.es/es/nota_legal

the_map <- get_data_aemet(a_map)
#> ℹ Response MIME type: "image/gif".
#> → Returning `raw` bytes. See also `base::writeBin()`.

# Write as GIF and include it.
giffile <- "example-gif.gif"
writeBin(the_map, giffile)

# Display in the vignette. It may be rotated.
knitr::include_graphics(giffile)

Example: surface analysis map provided by AEMET