NEWS
climaemet 1.6.0 (2026-06-03)
- Documentation, user-facing messages and internal code were reviewed and
refactored with AI assistance to improve consistency, maintainability, wording
and roxygen2 tag ordering.
- Tests now rely less on live AEMET API calls and cover additional
forecast-parsing branches using local fixtures.
- Requests now use a configurable timeout via
options(climaemet_timeout = 60).
aemet_api_key() now uses tools::R_user_dir() for persistent API key
storage. Existing users are migrated automatically to the new location,
ensuring backward compatibility.aemet_forecast_fires() has been updated to support the new API, which now
returns six risk levels. Risk values are returned as named factors instead of
numeric level codes.
climaemet 1.5.1 (2026-03-23)
- Vignettes were migrated to Quarto.
climaemet 1.5.0 (2026-01-11)
- Updated code for deprecations in ggplot2 >= 3.5.0.
- Messages, warnings and errors are now more informative thanks to cli.
- Performance improvements: climaemet now uses
httr2::req_throttle() to
manage API calls. The rate is strictly limited to the AEMET API policy: no
more than 40 connections per minute per API key.
- The minimum R version is now >= 4.1.0.
- Documentation and tests were updated.
climaemet 1.4.2 (2025-06-25)
- Functions were adapted to new AEMET API response codes (#74).
aemet_munic was updated with January 2025 data.ggwindrose() now uses ggplot2::coord_radial() instead of
ggplot2::coord_polar() and gains the stack_reverse argument to change the
order of the stacks on each petal (see #72).- The minimum required ggplot2 version is now >= 3.5.0 because
ggwindrose() now uses ggplot2::coord_radial().
climaemet 1.4.1 (2025-03-25)
- 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.
- Use CRAN DOI:
10.32614/CRAN.package.climaemet.
aemet_forecast_fires() now uses terra::combineLevels() (terra >=
1.8-10).
climaemet 1.4.0 (2024-08-28)
- Increased the timeout limit with
httr2::req_timeout().
- Improved handling of invalid, duplicated and empty API keys.
- Added terra to
Suggests.
aemet_alert_zones() retrieves the AEMET geographical zones used for
meteorological alerts.aemet_alerts() retrieves current meteorological alerts issued by AEMET.aemet_forecast_fires() retrieves forecast wildfire risk levels as a
SpatRaster.
climaemet 1.3.0 (2024-06-23)
- It is possible to use several API keys to avoid API throttling. See
?climaemet::aemet_api_key (#53).
- Migrate from httr to httr2 (#50).
- Added the
dms2decdegrees_2() helper.
- Added mapSpain to
Suggests.
- Progress bars are used in downloads thanks to cli. Most functions gain a
new
progress = TRUE argument.
- Updated
aemet_munic with January 2024 data.
aemet_beaches() and aemet_forecast_beaches() are new functions for beaches
(#54).
climaemet 1.2.1 (2024-01-30)
aemet_monthly_period(extract_metadata = TRUE) now honors the start and
end arguments.- Documentation was updated.
climaemet 1.2.0 (2023-08-30)
- Metadata can now be extracted from each API call using the
extract_metadata = TRUE argument (#40).
- The
aemet_stations() result is cached temporarily in tempdir(), avoiding
unnecessary API calls.
- The API call system has improved to avoid API throttling.
climaemet 1.1.1 (2023-05-25)
- Fix an error in the conversion to sf objects.
- Documentation was improved.
climaemet 1.1.0 (2023-02-16)
- Added lubridate and scales to
Suggests.
- Added the
aemet_munic dataset.
- Added
vignette("extending-climaemet", package = "climaemet").
- Fixed an error in
ggclimat_walter_lieth() (#35).
- Improved
get_data_aemet() and get_metadata_aemet() to support more
endpoints.
aemet_forecast_daily(), aemet_forecast_tidy(), aemet_forecast_hourly()
and aemet_forecast_vars_available() are new forecast functions.
climaemet 1.0.2 (2022-08-14)
- Documentation was updated as requested by CRAN.
climaemet 1.0.1 (2022-02-24)
- Added a new citation.
- Updated examples.
- climaemet no longer emits messages when loaded.
- Removed the lubridate dependency.
climaemet 1.0.0 (2021-09-16)
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
- API functions gain new arguments, such as
verbose, to check results.
- Tabular results are now returned as tibble objects.
- Results are parsed into the correct formats when possible, including numbers
and dates.
- Spatial support: the
return_sf argument returns sf objects instead of
tibble objects. sf (>= 0.9) is listed in Suggests, so it is not
strictly required.
Enhancements
- New example datasets:
climaemet_9434_climatogram, climaemet_9434_temp and
climaemet_9434_wind.
- Plot functions gain new arguments (
verbose and ...). Colors can now be
passed to the plotting functions.
aemet_daily_clim() is now vectorized and can also retrieve all stations with
station = "all".aemet_last_obs() is now vectorized and can also retrieve all stations with
station = "all".get_metadata_aemet() is a new function.ggclimat_walter_lieth() is a new function. It is now the default for
climatogram_* functions (experimental). Old behavior can be reproduced with
option ggplot2 = FALSE.
Internal changes
- Code was optimized.
- Dependencies were reviewed.
- Palettes are now generated with
base::hcl.colors() (base R).
climaemet 0.2.0 (2020-07-17)
climatogram_normal() is a new function for plotting a Walter-Lieth climate
diagram from climatological normal values.climatogram_period() is a new function for plotting a Walter-Lieth climate
diagram for a specified period.ggstripes_station() has been renamed to climatestripes_station().ggwindrose() is a new function for plotting wind roses.windrose_days() is a new function for plotting a wind rose for a weather
station over a range of days.windrose_period() is a new function for plotting a wind rose for a weather
station over a specified period.
climaemet 0.1.0 (2020-07-07)
- First release, July 2020.