Changelog

Source: NEWS.md

climaemet (development version)

• Performance improvements: now climaemet 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.
• Minimal R version now is >= 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 parameter stack_reverse for changing the order of the stacks on each petal.
• Minimal ggplot2 version required 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.
• Now the API key with the highest remaining quota is selected when performing a call (in prior versions the API key was chosen randomly). This is expected to delay 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 of risk level of wildfires.
• Increase timeout limit with httr2::req_timeout().
• Better management of non-valid/duplicated/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 parameters.
• Update docs.

climaemet 1.2.0

CRAN release: 2023-08-30

• Now it is possible to extract metadata from each API call using the parameter extract_metadata = TRUE (#40).
• Improve the API call system to avoid API throttling.
• aemet_stations() result is cached temporarily on tempdir(), avoiding unneeded 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:

• apikey parameter has been deprecated on all functions. Now the API key is globally managed via an environment variable: see aemet_api_key().

Major changes

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

Enhancements

• aemet_last_obs() is now vectorized and can also retrieve all stations at a glance with station = "all"
• aemet_daily_clim() is now vectorized and can also retrieve all stations at a glance with station = "all"
• New function get_metadata_aemet().
• New function ggclimat_walter_lieth(). This function is now the default for climatogram_* functions (experimental). Old behavior can be reproduced with option ggplot2 = FALSE.
• Plot functions gain new parameters (verbose and ...). Now it is possible to pass colors to the plotting functions.
• New example datasets: ?climaemet_9434_climatogram, ?climaemet_9434_temp, ?climaemet_9434_wind.

Internal changes

• Code optimization.
• Dependencies have been reviewed.
• Now palettes are 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 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.