Extending 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 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 23 DE MARZO DE 2025 A LAS 09:12 HORA OFICIAL PREDICCIÓN VÁLIDA PARA EL DOMINGO 23

A.- FENÓMENOS SIGNIFICATIVOS Precipitaciones persistentes en zonas próximas al litoral cantábrico, sin descartar que sean localmente fuertes al final del día. Probables chubascos ocasionalmente fuertes y con tormenta en la zona del Estrecho, sin descartarlos en otros puntos del sureste peninsular y en litorales y prelitorales de Cataluña. Nevadas con acumulaciones abundantes en los sistemas montañosos del norte y centro peninsular y en las montañas del sureste, principalmente al final del día. Intervalos de viento fuerte y probables rachas muy fuertes en litorales del Cantábrico y del Mar de Alborán. En Canarias rachas muy fuertes en vertientes expuestas de las islas de mayor relieve.

B.- PREDICCIÓN Aunque ya en fase de disolución, la presencia de la borrasca Martinho cerca del golfo de Vizcaya seguirá dejando los cielos muy nubosos o cubiertos en la mitad norte peninsular con precipitaciones persistentes y sin descartar que sean fuertes al final del día en zonas próximas al litoral cantábrico. En el resto, intervalos nubosos con chubascos que probablemente serán ocasionalmente fuertes en la zona del Estrecho y mar de Alborán, sin descartar que se produzcan también en litorales y prelitorales de Cataluña y en puntos del sureste peninsular. La cota de nieve se mantendrá en torno a 800/1000 m en meseta Norte y norte peninsular mientras que el sur y vertiente mediterránea se situará entre 1000/1400 m. Se esperan nevadas con acumulaciones abundantes en los sistemas montañosos del norte y centro peninsular y en montañas del sureste, sobre todo al final del día. Tampoco se descarta que haya chubascos en forma de nieve y/o nieve granulada en cotas más bajas de ambas mesetas. En Canarias, cielos nubosos con precipitaciones débiles en el norte de las islas e intervalos nubosos en el sur.

Las temperaturas seguirán descendiendo en la Península y Baleares aunque se esperan ligeros ascensos de las máximas en el oeste peninsular. En Canarias temperaturas sin cambios significativos. Las heladas ganan en extensión dándose en zonas de montaña y alrededores de los principales sistemas de la mitad norte y del sureste y de forma dispersa y débil en la meseta norte.

Soplarán vientos moderados, que serán de componente oeste en Baleares y en la Península, salvo en el extremo noroeste donde soplará del norte. Cierzo en el bajo Ebro. Se prevé alcanzar intervalos de fuerte y probables rachas muy fuertes en litorales del Cantábrico y del mar de Alborán. Intervalos de fuerte en los litorales atlánticos de Galicia. En Canarias continuará el norte moderado con probables intervalos de fuerte y rachas muy fuertes en vertientes expuestas de las islas de mayor relieve.


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 data


# 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

Example: Surface analysis map provided by AEMET