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 17 DE JULIO DE 2026 A LAS 08:54 HORA OFICIAL PREDICCIÓN VÁLIDA PARA EL VIERNES 17

A.- FENÓMENOS SIGNIFICATIVOS Temperaturas significativamente altas en Baleares, tercio este peninsular y Andalucía. Tormentas en el interior del tercio sudeste peninsular que pueden venir acompañadas de rachas de viento muy fuertes.

B.- PREDICCIÓN Se mantendrá la estabilidad en la mayor parte del país, con cielos poco nubosos o despejados. Únicamente en Galicia y área cantábrica estarán nubosos o cubiertos con probables precipitaciones, en general débiles y ocasionales, pero que a primeras horas podrán ser localmente fuertes en puntos del litoral cantábrico. Asimismo se prevé la entrada de nubosidad de tipo medio y alto por el sureste peninsular y Baleares y por la tarde la formación de nubes de evolución en el tercio oriental, pudiendo dejar alguna tormenta, y que en zonas del sudeste pueden venir acompañadas de rachas de viento muy fuertes. También intervalos nubosos en el norte de las islas Canarias.

Probables bancos de niebla matinales en Galicia y área cantábrica, con calima en el sur y este de la Península y Baleares.

Las temperaturas máximas descenderán en los archipiélagos y en la mayor parte del tercio norte peninsular, exceptuando en el oeste de Galicia en aumento al igual que en el entorno del Guadalquivir y puntos de Murcia y Alicante. Pocos cambios en el resto. Se superarán los 35 grados en Baleares y amplias zonas de la Península, exceptuando cuadrante noroeste y Cantábrico; pudiendo incluso rebasar los 40 en interiores del sureste y puntos de Alborán y Guadalquivir. Las mínimas descenderán en la mayor parte de la Península, con ligeros aumentos en Baleares y sin cambios en Canarias. No bajarán de 20 grados, incluso localmente de 25, en regiones de Andalucía, Mediterráneo, Canarias e interior de los tercios nordeste y sureste peninsular.

Soplará el alisio en Canarias con intervalos fuertes en zonas expuestas, con viento moderado del sur rolando a norte flojo en Baleares y poniente moderado en los litorales del sur peninsular amainando en Alborán. En el resto viento flojo de componente oeste, salvo en el Cantábrico y Galicia donde será de norte y en el Levante donde será de norte y este; arreciando por la tarde en litorales gallegos y en zonas de interior del centro norte y este peninsular.

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