Changelog

Source: NEWS.md

climaemet 1.5.1

CRAN release: 2026-03-23

• Migrate vignettes to Quarto.

climaemet 1.5.0

CRAN release: 2026-01-11

• Performance improvements: climaemet now uses httr2::req_throttle() to manage API calls. The rate is strictly limited to AEMET API policy: no more than 40 connections per minute per API key.
• Update docs and tests.
• Adapt deprecations of ggplot2 >= 3.5.0.
• Messages, warnings and errors are now more informative thanks to cli.
• The minimum R version is now >= 4.1.0.

climaemet 1.4.2

CRAN release: 2025-06-25

• Improvements in ggwindrose() (see #72):
  • Use ggplot2::coord_radial() instead of ggplot2::coord_polar().
  • New argument stack_reverse for changing the order of the stacks on each petal.
• The minimum required ggplot2 version is now >= 3.5.0 as a consequence of migrating to ggplot2::coord_radial().
• ?aemet_munic updated to January 2025.
• Adapt functions to new response codes (#74).

climaemet 1.4.1

CRAN release: 2025-03-25

• aemet_forecast_fires() now uses terra::combineLevels() (terra >= 1.8-10).
• Use CRAN DOI: 10.32614/CRAN.package.climaemet.
• The API key with the highest remaining quota is now selected when performing a call. In prior versions, the API key was chosen randomly. This is expected to reduce API throttling.

climaemet 1.4.0

CRAN release: 2024-08-28

• New functions:
  • aemet_alerts() to get current meteorological alerts issued by AEMET.
  • Helper function aemet_alert_zones() to obtain the zoning defined by AEMET for the alerts.
  • aemet_forecast_fires() to get a SpatRaster with the forecast wildfire risk level.
• Increase timeout limit with httr2::req_timeout().
• Better management of invalid, duplicated and empty API keys.
• New package added to Suggests: terra.

climaemet 1.3.0

CRAN release: 2024-06-23

• Migrate from httr to httr2 (#50).
• New functions for beaches: aemet_forecast_beaches() and aemet_beaches() (#54).
• Use progress bars in downloads thanks to cli. New argument progress = TRUE in most functions.
• It is possible to use several API keys to avoid API throttling. See ?climaemet::aemet_api_key (#53).
• New helper function dms2decdegrees_2().
• Update ?aemet_munic with January 2024 data.
• New package in Suggests: mapSpain.

climaemet 1.2.1

CRAN release: 2024-01-30

• On aemet_monthly_period(extract_metadata = TRUE) honor the start and end arguments.
• Update docs.

climaemet 1.2.0

CRAN release: 2023-08-30

• Metadata can now be extracted from each API call using the argument extract_metadata = TRUE (#40).
• Improve the API call system to avoid API throttling.
• The aemet_stations() result is cached temporarily in tempdir(), avoiding unnecessary API calls.

climaemet 1.1.1

CRAN release: 2023-05-25

• Fix an error on the conversion to sf objects.
• Documentation improvements.

climaemet 1.1.0

CRAN release: 2023-02-16

• Add lubridate to “Suggests”.
• Add ?aemet_munic dataset.
• Add scales to Suggests.
• Add forecast functions:
  • aemet_forecast_daily()
  • aemet_forecast_tidy()
  • aemet_forecast_hourly()
  • aemet_forecast_vars_available()
• Improve get_data_aemet()/get_metadata_aemet() to support more endpoints.
• Add new vignette: vignette("extending-climaemet").
• Fix error on ggclimat_walter_lieth() (#35).

climaemet 1.0.2

CRAN release: 2022-08-14

• Fix docs as per CRAN request.

climaemet 1.0.1

CRAN release: 2022-02-24

• Add new citation.
• Adapt some examples.
• Remove lubridate dependency.
• No more messages when loading the library.

climaemet 1.0.0

CRAN release: 2021-09-16

• Package added to rOpenSpain project: repo transferred to https://github.com/rOpenSpain/climaemet

Breaking changes:

• The apikey argument has been deprecated in all functions. The API key is now globally managed via an environment variable. See aemet_api_key().

Major changes

• Results are now provided in tibble format.
• Results are parsed into the correct formats (numbers and dates when possible).
• Spatial support: New option return_sf returns sf objects instead of tibble objects. sf (>= 0.9) is listed in Suggests, so it is not strictly required.
• API functions gain new arguments, such as verbose, to check results.

Enhancements

• aemet_last_obs() is now vectorized and can also retrieve all stations with station = "all".
• aemet_daily_clim() is now vectorized and can also retrieve all stations with station = "all".
• New function get_metadata_aemet().
• New function ggclimat_walter_lieth(). It is now the default for climatogram_* functions (experimental). Old behavior can be reproduced with option ggplot2 = FALSE.
• Plot functions gain new arguments (verbose and ...). Colors can now be passed to the plotting functions.
• New example datasets: ?climaemet_9434_climatogram, ?climaemet_9434_temp, ?climaemet_9434_wind.

Internal changes

• Code optimization.
• Dependencies have been reviewed.
• Palettes are now generated with base::hcl.colors() (base R).

climaemet 0.2.0

CRAN release: 2020-07-17

• Rename ggstripes_station() to climatestripes_station().
• climatogram_normal(). New function to plot a Walter & Lieth climatic diagram from normal climatology values.
• climatogram_period(). New function to plot a Walter & Lieth climatic diagram for a specified time period.
• ggwindrose(). New function to plot a windrose diagram.
• windrose_days(). New function to plot a windrose (speed/direction) diagram of a station over days.
• windrose_period(). New function to plot a windrose (speed/direction) diagram of a station over a time period.

climaemet 0.1.0

CRAN release: 2020-07-07

• First release July 2020.