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

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

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/obtencionAPIKey.

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. Just type:

aemet_api_key("YOUR_API_KEY", install = TRUE)

Using install = TRUE ensures that the API key is stored on your local computer and it will be reloaded every time you load the library. From now on you can forget about API keys!

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 only valid 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. You can start editing your .Renviron file by running this command:

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 v1.0.0 onward, climaemet returns its results in tibble format. The functions also try to parse fields into their correct types (for example, date/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: 13 × 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-04-24 21:00:00     0   249   4.3   2     106  41.7   103
#>  2 9434  -1.00 2026-04-24 22:00:00     0   249   2.7   2.2   107  41.7    95
#>  3 9434  -1.00 2026-04-24 23:00:00     0   249   2.9   1.5    66  41.7   110
#>  4 9434  -1.00 2026-04-25 00:00:00     0   249   3.2   1.1    72  41.7    85
#>  5 9434  -1.00 2026-04-25 01:00:00     0   249   2.5   1.4   121  41.7    85
#>  6 9434  -1.00 2026-04-25 02:00:00     0   249   3.3   1.2    96  41.7   138
#>  7 9434  -1.00 2026-04-25 03:00:00     0   249   1.4   1      66  41.7   318
#>  8 9434  -1.00 2026-04-25 04:00:00     0   249   2.1   1.3   121  41.7   138
#>  9 9434  -1.00 2026-04-25 05:00:00     0   249   2.3   0.9   253  41.7   303
#> 10 9434  -1.00 2026-04-25 06:00:00     0   249   2.9   1.1   325  41.7   310
#> 11 9434  -1.00 2026-04-25 07:00:00     0   249   4.7   3.1   314  41.7   315
#> 12 9434  -1.00 2026-04-25 08:00:00     0   249   8.6   5.6   304  41.7   290
#> 13 9434  -1.00 2026-04-25 09:00:00     0   249   9     3.7   330  41.7   303
#> # ℹ 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>

Note that when possible, data representing dates and numbers are converted to the right format.

Spatial objects: sf

Another major change in v1.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 (WGS) and returns coordinates in latitude/longitude (unprojected coordinates):

# You need to install `sf` if it is not already installed
# 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

Example: Temperature in Spain

Further enhancements

Other enhancements included in the v1.0.0: