Changes in version 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().

                 Changes in version 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).

                 Changes in version 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.

                 Changes in version 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).

                 Changes in version 0.9.2 (2024-08-26)                  

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

                 Changes in version 0.9.1 (2024-06-10)                  

  - Updated actions and documentation.

                 Changes in version 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.

                 Changes in version 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.

                 Changes in version 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.

                 Changes in version 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().

                 Changes in version 0.6.1 (2022-02-25)                  

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

                 Changes in version 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.

                 Changes in version 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).

                 Changes in version 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.

                 Changes in version 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.

                 Changes in version 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.

                 Changes in version 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.

                 Changes in version 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").

                 Changes in version 0.2.1 (2021-03-19)                  

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

                 Changes in version 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.

                 Changes in version 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.

                 Changes in version 0.1.1 (2020-11-30)                  

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

                        Changes in version 0.1.0                        

  - Initial release.