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.
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 18 DE MARZO DE 2025 A LAS 08:49 HORA OFICIAL PREDICCIÓN VÁLIDA PARA EL MARTES 18
A.- FENÓMENOS SIGNIFICATIVOS Se esperan precipitaciones localmente fuertes y persistentes en la mitad sur peninsular que se irán trasladando hacia el noreste de la Península con abundantes acumulaciones en el sureste de Andalucía, Comunidad Valenciana, sur Tarragona y noreste de Cataluña. En litorales mediterráneos los chubascos podrían ser puntualmente muy fuertes y acompañados de tormenta. Ascenso notable de las temperaturas mínimas en el este de Castilla y León, Cordillera Cantábrica y norte del Sistema Ibérico. Probables rachas muy fuertes durante la madrugada en el litoral andaluz y al final del día en el Alto Ebro y Cantábrico oriental.
B.- PREDICCIÓN La posición de la baja Laurence en el suroeste peninsular dará lugar a cielos muy nubosos o cubiertos en la Península y Baleares con precipitaciones generalizadas menos frecuentes en el litoral norte peninsular. Durante la primera mitad del día se esperan precipitaciones localmente fuertes y persistentes en la mitad sur peninsular que se irán trasladando hacia el noreste de la Península. Por esta razón se espera durante la madrugada y la mañana las mayores acumulaciones de precipitación en el sureste de Andalucía y por la tarde hasta el final del día en la Comunidad Valenciana, sur de Tarragona y noreste de Cataluña. En litorales mediterráneos los chubascos podrían ser puntualmente muy fuertes y acompañados de tormenta. Además en el Sistema Central también se esperan acumulaciones significativas al ser las precipitaciones persistentes todo el día. Se producirán nevadas abundantes en zonas altas montañosas del norte y sureste al estar la cota entre 1400/1800 m. En Canarias, intervalos nubosos sin descartar algunos chubascos débiles.
Las temperaturas máximas tendrán en general un ascenso en todo el país que será más acusado en el Cantábrico y en el extremo sureste peninsular. Mínimas sin cambios significativos en el sur peninsular y Canarias y en ascenso en el resto de la Península y Baleares, de forma notable en el este de Castilla y León, Cordillera Cantábrica y norte del Sistema Ibérico. Las heladas serán débiles y dispersas en montañas del interior, moderadas en los Pirineos.
Los vientos soplarán entre flojos y moderados del suroeste rolando a sur en la mitad oeste y sur peninsular, y moderados del este y sureste en el resto de la Península y Baleares con probables rachas muy fuertes al final del día en el Alto Ebro y Cantábrico oriental. Durante la madrugada y primeras horas de la mañana se esperan en el litoral andaluz intervalos de fuerte y probables rachas muy fuertes. En Canarias soplaran vientos moderados del norte rolando a oeste.
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