Since the last release, this package has been integrated into rOpenSpain, a community of R enthusiasts whose ultimate goal is to create high-quality R packages for data mining public Spanish open sources.
From version 1.0.0 onward, we have introduced some improvements and (breaking) changes on the package, in order to provide a smoother interaction with the AEMET API service.
To be able to download data from AEMET you will need a free API key which you can get at https://opendata.aemet.es/centrodedescargas/obtencionAPIKey
Once that you have your API Key, you can use any of the following methods:
aemet_api_key()This is the recommended option. Just type:
Using install = TRUE ensures that the API key is stored
on your local computer and it would be reloaded every time you load the
library. From now on you can forget about API keys!
This is a temporary alternative. You can set your API key as an environment variable
Note that this is only valid for the current session. You would need to re-run this command each time you restart your session.
tidyverse formatFrom v1.0.0 onward, climaemet provides its results in tibble format. Also, the functions try to guess the correct format of the fields (i.e. something as a Date/Hour now is an hour, numbers are parsed as double, etc.).
See how a tibble is displayed:
# See a tibble in action
aemet_last_obs("9434")
#> # A tibble: 24 × 25
#> idema lon fint prec alt vmax vv dv lat dmax ubi
#> <chr> <dbl> <dttm> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> <chr>
#> 1 9434 -1.00 2024-01-29 22:00:00 0 249 1.2 0.9 186 41.7 190 ZARAGOZA …
#> 2 9434 -1.00 2024-01-29 23:00:00 0 249 2 0.6 209 41.7 248 ZARAGOZA …
#> 3 9434 -1.00 2024-01-30 00:00:00 0 249 1.5 1.2 189 41.7 183 ZARAGOZA …
#> 4 9434 -1.00 2024-01-30 01:00:00 0 249 1.6 0.6 165 41.7 195 ZARAGOZA …
#> 5 9434 -1.00 2024-01-30 02:00:00 0 249 1.2 0.8 313 41.7 178 ZARAGOZA …
#> 6 9434 -1.00 2024-01-30 03:00:00 0 249 1.5 1 281 41.7 275 ZARAGOZA …
#> 7 9434 -1.00 2024-01-30 04:00:00 0 249 2.4 1.1 321 41.7 253 ZARAGOZA …
#> 8 9434 -1.00 2024-01-30 05:00:00 0 249 1.2 0.7 238 41.7 323 ZARAGOZA …
#> 9 9434 -1.00 2024-01-30 06:00:00 0 249 1.5 0.9 195 41.7 218 ZARAGOZA …
#> 10 9434 -1.00 2024-01-30 07:00:00 0 249 1.4 0.8 281 41.7 198 ZARAGOZA …
#> # ℹ 14 more rows
#> # ℹ 14 more variables: pres <dbl>, hr <dbl>, stdvv <dbl>, ts <dbl>, pres_nmar <dbl>,
#> # tamin <dbl>, ta <dbl>, tamax <dbl>, tpr <dbl>, stddv <dbl>, inso <dbl>,
#> # tss5cm <dbl>, pacutp <dbl>, tss20cm <dbl>Note that when possible, data representing dates and numbers are converted to the right format.
sfAnother major change in v1.0.0 is the ability of
return information on spatial sf format, using
return_sf = TRUE. The coordinate reference system (CRS)
used is EPSG 4326, that correspond to the World
Geodetic System (WGS) and return coordinates in
latitude/longitude (unprojected coordinates):
# You would need to install `sf` if not installed yet
# run install.packages("sf") for installation
library(ggplot2)
library(dplyr)
all_stations <- aemet_daily_clim(
start = "2021-01-08", end = "2021-01-08",
return_sf = TRUE
)
ggplot(all_stations) +
geom_sf(aes(colour = tmed), shape = 19, size = 2, alpha = 0.95) +
labs(
title = "Average temperature in Spain",
subtitle = "8 Jan 2021",
color = "Max temp.\n(celsius)",
caption = "Source: AEMET"
) +
scale_colour_gradientn(
colours = hcl.colors(10, "RdBu", rev = TRUE),
breaks = c(-10, -5, 0, 5, 10, 15, 20),
guide = "legend"
) +
theme_bw() +
theme(
panel.border = element_blank(),
plot.title = element_text(face = "bold"),
plot.subtitle = element_text(face = "italic")
)
Example: Temperature in Spain
Other enhancements included on the v1.0.0:
get_metadata_aemet().ggclimat_walter_lieth(). This function is
now the default for climatogram_* functions (experimental).
Old behavior can be reproduced with options
ggplot2 = FALSE.verbose and
...). Now it is possible to pass colors to the plotting
functions.climaemet::climaemet_9434_climatogram,
climaemet::climaemet_9434_temp,
climaemet::climaemet_9434_wind.