Extending climaemet • climaemet

climaemet provides several functions for accessing a selection of endpoints of the AEMET API tool. However, this package does not cover in full all the capabilities of the API.

For that reason, we provide the get_data_aemet() function, that allows to access any API endpoint freely. The drawback is that the user would need to handle the results by him/herself.

library(climaemet)

Example: Normalized text

Some API endpoints, as predicciones-normalizadas-texto, provides the results as plain text on natural language. These results are not parsed by climaemet, but can be retrieved as this:

# endpoint, today forecast

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

# 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


# Data
pred_today <- get_data_aemet(today)
#> ℹ Results are MIME type: "text/plain".
#> → Returning data as UTF-8 string.

# Produce a result

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

cat(paste("---\n\n", clean, "\n---"))

AGENCIA ESTATAL DE METEOROLOGÍA PREDICCIÓN GENERAL PARA ESPAÑA DÍA 19 DE ENERO DE 2026 A LAS 09:12 HORA OFICIAL PREDICCIÓN VÁLIDA PARA EL LUNES 19

A.- FENÓMENOS SIGNIFICATIVOS Precipitaciones fuertes y persistentes en Baleares y extremo nordeste peninsular, sobre todo en Girona. Nevadas con importantes acumulados que pueden afectar a los Pirineos orientales y, a últimas horas, a la Ibérica oriental. Viento fuerte con rachas muy fuertes del este y nordeste al final del día en el litoral catalán y en Baleares. En Canarias viento del nordeste fuerte con rachas muy fuertes.

B.- PREDICCIÓN El paso de una dana hacia el Mediterráneo junto con la formación de la borrasca Harry al norte de Argelia dejará una situación muy inestable en el Mediterráneo occidental, con un temporal que afectará al nordeste peninsular y a Baleares. Asimismo, un frente atlántico dejará precipitaciones en los litorales atlánticos, afectando a Galicia y al Cantábrico. Se esperan precipitaciones, sobre todo, en el nordeste y Baleares, sin descartarlas de forma débil en el Sistema Central e Ibéricas y de forma aislada en la Meseta. Los mayores acumulados serán en el nordeste peninsular y Baleares, con precipitaciones muy fuertes y persistentes, especialmente en Girona. Se esperan nevadas en los sistemas montañosos, que serán débiles en los del centro y norte, con una cota en torno a 1000-1200 m y nevadas que tendrán acumulados muy importantes en el Pirineo oriental por encima de 1400-1600 m y al final en la Ibérica este con una cota a 1100-1300 m. En Canarias, cielos nubosos con precipitaciones en los nortes.

Brumas y nieblas en zonas de montaña del norte, que pueden ser persistentes en el Pirineo oriental. Bancos de niebla matinales en la meseta norte.

Temperaturas máximas en descenso en el noroeste y montañas del este, y en ascenso en el arco mediterráneo, oeste de las mesetas y el Ebro. Sin cambios o descensos puntuales en el resto. Mínimas en ligero descenso en el nordeste, valles del suroeste y en el Cantábrico. Pocos cambios en Canarias. Heladas débiles en los sistemas montañosos peninsulares y localmente en la meseta, moderadas en cumbres.

Viento del norte y oeste flojo en el interior de la Península. En los litorales atlántico y mediterráneo, viento moderado de componente norte que rolará a fuerte del este al norte de Baleares y en Ampurdán, originando un temporal marítimo con rachas muy fuertes en la costa. En el Golfo de Cádiz y Alborán, poniente con intervalos de fuerte en Alborán. En Canarias, alisio moderado con intervalos de fuerte y rachas muy fuertes.

Example: Maps

AEMET also provides map data, usually on image/gif format. One way to get this kind of data is as follows:

# Endpoint of a map
a_map <- "/api/mapasygraficos/analisis"

# 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)
#> ℹ Results are MIME type: "image/gif".
#> → Returning <raw> bytes. See also `


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

# Display on the vignette
knitr::include_graphics(giffile)

Example: Surface analysis map provided by AEMET