Skip to contents

Get started with climaemet 1.0.0

Diego Hernangómez

Source: vignettes/climaemet.qmd

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 working with public Spanish open data sources.

As of version 1.0.0, the package includes improvements and breaking changes for smoother interaction with the AEMET API.

API key

Get your API key

To download data from AEMET, you need a free API key, which you can get at https://opendata.aemet.es/centrodedescargas/altaUsuario.

Once you have your API key, you can use any of the following methods:

a. Set API key with aemet_api_key()

This is the recommended option. Run:

aemet_api_key("YOUR_API_KEY", install = TRUE)

Using install = TRUE stores the API key on your local computer and reloads it each time you load the package.

b. Use an environment variable

This is a temporary alternative. You can set your API key as an environment variable:

Sys.setenv(AEMET_API_KEY = "YOUR_API_KEY")

Note that this is valid only for the current session. You need to run this command each time you restart your R session.

c. Modify your .Renviron file

This stores your API key permanently on your machine. Start editing your .Renviron file with:

usethis::edit_r_environ()

Now you can add the following line to your .Renviron file:

AEMET_API_KEY=YOUR_API_KEY

New features

tibble format

From version 1.0.0 onward, climaemet returns its results in tibble format. The functions also try to parse fields into their correct types. For example, date and hour fields are parsed as date-time objects and numeric fields as double values.

See how a tibble is displayed:

# See a tibble in action

aemet_last_obs("9434")
#> # A tibble: 12 × 25
#>    idema   lon fint                 prec   alt  vmax    vv    dv   lat  dmax
#>    <chr> <dbl> <dttm>              <dbl> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl>
#>  1 9434  -1.00 2026-06-07 18:00:00     0   249   9.3   6.1   112  41.7   105
#>  2 9434  -1.00 2026-06-07 19:00:00     0   249  12     7     128  41.7   125
#>  3 9434  -1.00 2026-06-07 20:00:00     0   249  10     4.8   126  41.7   118
#>  4 9434  -1.00 2026-06-07 21:00:00     0   249   8.6   6     115  41.7   120
#>  5 9434  -1.00 2026-06-07 22:00:00     0   249   8.3   5.9   113  41.7   115
#>  6 9434  -1.00 2026-06-07 23:00:00     0   249   9     3.9   105  41.7    95
#>  7 9434  -1.00 2026-06-08 00:00:00     0   249   7.5   4.2   113  41.7   125
#>  8 9434  -1.00 2026-06-08 01:00:00     0   249   6.2   3.3   112  41.7   118
#>  9 9434  -1.00 2026-06-08 02:00:00     0   249   4.8   3     128  41.7   145
#> 10 9434  -1.00 2026-06-08 03:00:00     0   249   4.8   3     137  41.7   143
#> 11 9434  -1.00 2026-06-08 04:00:00     0   249   4.7   2.4   130  41.7   150
#> 12 9434  -1.00 2026-06-08 05:00:00     0   249   2.8   1.3   111  41.7   148
#> # ℹ 15 more variables: ubi <chr>, 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>

When possible, data representing dates and numbers are converted to the appropriate type.

Spatial objects with sf

Another major change in version 1.0.0 is the ability to return information in spatial sf format using return_sf = TRUE. The coordinate reference system (CRS) used is EPSG:4326, which corresponds to the World Geodetic System 1984 (WGS 84) and returns coordinates in latitude/longitude (unprojected coordinates):

# You need to install sf if it is not already installed.
# Run install.packages("sf") to install it.

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

Example: temperature in Spain

Further enhancements

Other enhancements included in version 1.0.0: