NEWS

---

mapSpain 1.1.0.9000

• Refactored internal helpers for downloading and reading geospatial files, SIANE file handling, EPSG validation, region-code filtering, municipal metadata enrichment, empty-result messages and Canary Islands displacement. This is intended to simplify maintenance without changing the public API.
• Consolidated repeated CCAA, province and municipality metadata handling across GISCO, SIANE, simplified and gridmap getters.
• Further simplified internal cache handling, sf output finalization, WMTS tile retrieval, dictionary translation and no-match messages. These changes are intended to improve maintainability without changing user-facing behavior.
• Reviewed roxygen2 documentation, generated Rd files and prose documentation for consistent terminology and clearer user-facing messages. This work was completed with AI assistance and human review.
• This internal refactor was developed with AI assistance and reviewed through focused package checks, including devtools::load_all() followed by lintr::lint_package().

mapSpain 1.1.0 (2026-03-26)

• Migrated package vignettes to Quarto.
• Minimum httr2 version is now 1.2.0 to ensure compatibility with giscoR.
• Query timeout can be controlled with options(mapspain_timeout) using httr2::req_timeout(). The default value is httr2::req_timeout(..., seconds = 300) (5 minutes).

mapSpain 1.0.0 (2026-01-17)

This major release introduces a full overhaul of the codebase and test suite. Requests now use httr2, and cached files are reorganized into topic-based subfolders for easier management.

Because of internal changes, existing caches are not compatible with this release and must be rebuilt.

We have transitioned from rappdirs::user_config_dir() to tools::R_user_dir() for managing the persistent cache directory. If you have an existing cache directory, you will receive a one-time notification about this migration.

The package now requires R >= 4.1, and dependency updates improve performance and maintainability. All functions return tidy objects, either tibbles or sf objects with tibble data.

Several new functions and arguments have been added, some functions renamed and some others deprecated. All bundled datasets have been updated to their latest versions.

Breaking changes

• Minimum required R version is now 4.1.0.
• Removed dependency on slippymath (#126).
• esp_get_grid_EEA() is deprecated and defunct because the source file is no longer available.
• providerEspTileOptions() has been removed, use leaflet::providerTileOptions() instead.
• Removed dataset ?esp_munic.sf.
• Removed dataset ?leaflet.providersESP.df, superseded in mapSpain v0.8.0.
• Removed dataset ?pobmun19, replaced by ?pobmun25.

Deprecations and new function names

• esp_get_country() has been renamed to esp_get_spain(), the old name still works.
• esp_get_rivers() deprecates the resolution and spatialtype arguments. Wetlands support has been moved to the new esp_get_wetlands() function.
• esp_getTiles() has been renamed to esp_get_tiles(), the old name still works.

New features

• Added dataset ?esp_nuts_2024, replacing ?esp_nuts.sf.
• esp_get_attributions() retrieves tile provider attributions.
• esp_get_countries_siane() retrieves all countries available in SIANE at a given date.
• esp_get_rivers() gains a new moveCAN argument.
• esp_get_spain_siane() is analogous to esp_get_spain() but uses SIANE data.
• esp_get_stations() replaces esp_get_railway(..., spatialtype = "point").
• esp_get_tiles() can be used with providers that need an API key.
• esp_siane_bulk_download() downloads all SIANE datasets to a specified cache_dir in a single step.

mapSpain 0.10.0 (2024-12-15)

• esp_get_comarca() gains a new type argument to extract official (IGN), statistical (INE), agrarian or livestock comarcas (MAPA).
• esp_get_prov_siane() fixes a bug when selecting columns (#115).

mapSpain 0.9.2 (2024-08-26)

• Adapted functions to the SIANE 2024 databases.
• esp_dict_region_code() and esp_dict_translate() improve dictionary support.

mapSpain 0.9.1 (2024-06-10)

• Updated actions and documentation.

mapSpain 0.9.0 (2024-01-23)

• Changed how modifications to Canary Islands objects are handled (#101).
• esp_detect_cache_dir() shows the current cache directory.
• esp_move_can() was added as a helper to displace stand-alone sf objects in the Canary Islands.
• esp_move_can() is used internally by all functions.
• layer_spatraster() was removed, it was deprecated in mapSpain 0.6.2.

mapSpain 0.8.0 (2023-07-12)

• Improved download of NUTS data from giscoR.
• Upgraded ?esp_tiles_providers to https://dieghernan.github.io/leaflet-providersESP/ v1.3.3. New providers include IDErioja.Base, IDErioja.Relieve, IDErioja.Claro and IDErioja.Oscuro.
• esp_getTiles() now supports non-OGC-compliant WMTS providers, such as Stamen or OpenStreetMap. See examples.

mapSpain 0.7.0 (2022-12-22)

• Changed how the package manages tile providers.
• Upgraded ?leaflet.providersESP.df to https://dieghernan.github.io/leaflet-providersESP/ v1.3.2.
• ?leaflet.providersESP.df is superseded in favor of ?esp_tiles_providers.
• esp_getTiles() can use a custom URL with the type argument (#88).
• esp_make_provider() was added to help create custom providers.

mapSpain 0.6.2 (2022-08-13)

• moveCAN is now an explicit argument in the relevant functions.
• Deprecated layer_spatraster(). Use tidyterra::geom_spatraster_rgb() instead.
• esp_get_comarca() gets comarcas from INE.
• esp_get_hex_prov() and esp_get_hex_ccaa() fix geometries.
• Added functions to get simplified maps from INE, esp_get_simpl_prov() and esp_get_simpl_ccaa().

mapSpain 0.6.1 (2022-02-25)

• esp_getTiles() fixes a bug when mask = TRUE.

mapSpain 0.6.0 (2022-02-18)

• Improved regex search on municipalities. Letter case is now ignored.
• Upgraded ?leaflet.providersESP.df to https://dieghernan.github.io/leaflet-providersESP/ v1.3.0. New providers include Catastro.BuildingPart, Catastro.AdministrativeBoundary and Catastro.AdministrativeUnit.
• esp_getTiles() gains a new options argument.

mapSpain 0.5.0 (2022-01-25)

• Rebuilt coding database to avoid encoding errors.
• Fixed Galician translations.
• Added grid functionsesp_get_grid_MTN(), esp_get_grid_BDN(), esp_get_grid_EEA() and esp_get_grid_ESDAC() (#61).

mapSpain 0.4.0 (2021-10-14)

• Switched from raster to terra.
• Cleaned up dependencies. Imagery packages moved to Suggests.
• Added layer_spatraster().
• Moved examples to ggplot2.

mapSpain 0.3.1 (2021-09-10)

• Fixed an error on CRAN related to the cache folder (#52).
• Added esp_clear_cache().
• Updated documentation with @family tags.

mapSpain 0.3.0 (2021-09-01)

• Added tests with testthat.
• Precomputed the vignette.
• Refactored sysdata.rda.
• Updated documentation with new examples.
• esp_getTiles() gains a new zoommin argument.
• esp_set_cache_dir() improves caching with rappdirs::user_cache_dir(). The cache_dir path is now stored, so it does not need to be set again in each new session.

mapSpain 0.2.3 (2021-04-25)

• Moved minimum version of giscoR to v0.2.4.
• Fixed typos in esp_dict_translate() (#36).
• Do not run examples on tiles because the server sometimes does not respond.
• CRAN fixes removed a broken link in addProviderEspTiles() and removed the vignette after a CRAN warning.
• Refactored sysdata.rda.
• Now the cache directory is created recursively.

mapSpain 0.2.2 (2021-04-17)

• Migrated examples, vignettes and README to tmap.
• Added vignette to the package.
• esp_dict_region_code() works with mixed casing, for example esp_dict_region_code("aLbacEte", destination = "cpro").

mapSpain 0.2.1 (2021-03-19)

• Fixed a documentation typo: cache_dir should be set as options(mapSpain_cache_dir = "path/to/dir").

mapSpain 0.2.0 (2021-02-25)

• Fixed DOI https://doi.org/10.5281/zenodo.4318024.
• Ported documentation to roxygen2.
• Included CartoBase ANE data https://github.com/rOpenSpain/mapSpain/tree/sianedata, with esp_get_munic_siane(), esp_get_prov_siane(), esp_get_ccaa_siane(), esp_get_hypsobath(), esp_get_rivers(), esp_get_hydrobasin(), esp_get_capimun(), esp_get_roads() and esp_get_railway().
• Muted warnings from rgdal.

mapSpain 0.1.2 (2021-01-05)

• Fixed a warning when sf was not loaded first.
• Added more years to esp_get_munic().
• Created new grids with geogrid::calculate_grid().
• Moved to rOpenSpain organization.
• esp_get_can_box() gains a new poly option.

mapSpain 0.1.1 (2020-11-30)

• Fixed CRAN submission.
• Added esp_get_grid_prov() and esp_get_grid_ccaa().

mapSpain 0.1.0

• Initial release.