LoginSign Up
← Back to all sparks
M

mapSpain

ANALYTICS
Velocity0.0

Administrative Boundaries and Static Map Tiles for Spain

github.com/rOpenSpain/mapSpain ↗

mapSpain's 1.0.0 broke every user cache to get the package onto modern foundations.

spainadministrative-boundariesgeospatialhttr2cachingr-package
◆Current state
mapSpain provides administrative boundaries, tile providers and geographic dictionaries for Spain, pulling from GISCO, SIANE, INE and IGN sources. The 1.0.0 release in January 2026 rebuilt it: requests moved to httr2, the cache reorganized into topic-based subfolders under tools::R_user_dir() instead of rappdirs, R 4.1 became the floor, and every function now returns tidy objects. Existing caches are explicitly incompatible and must be rebuilt.
◆Where it's heading
The package has finished its modernization and moved into consolidation. 1.1.0 added a configurable query timeout and pinned httr2 for compatibility with giscoR, the sibling package it shares plumbing with; 1.2.0 was a declared internal-only refactor with the public API held fixed and the work described as AI-assisted with human review. The data-source expansion that characterized the 0.9.x and 0.10.x line — comarcas by type, simplified INE geometries, SIANE vintages — has paused while the foundations settle.
◆Prediction
Expect a return to source coverage now that the refactor is done: new SIANE or INE vintages and additional boundary types are the pattern this package has repeated. The entries show no further architectural work queued.

◆Recent moves

  1. 1mo ago

    Internal helper refactor with the public API held fixed

    A broad internal consolidation — download helpers, SIANE handling, EPSG validation, cache management, Canary Islands displacement — explicitly scoped to leave the public API and user-facing behavior unchanged. The maintainer states the work was AI-assisted with human review.

    View source ↗
  2. 4mo ago

    Query timeout becomes configurable

    options(mapspain_timeout) exposes the request timeout, defaulting to five minutes — a practical concession to slow national geoportals. The httr2 floor is raised to 1.2.0 for compatibility with giscoR, confirming the two packages are maintained as a pair.

    View source ↗
  3. 7mo ago

    1.0.0 rebuilds on httr2 and invalidates every cache

    ⚡ SPARK

    The release the rest of this window orbits: everything before it is source expansion, everything after is consolidation on the new foundation. It is also the moment mapSpain accepted a hard break with its installed base to get there.

    View source ↗
  4. 1y ago

    Comarcas and simplified INE geometries added

    esp_get_comarca() opens a boundary level the package did not cover, alongside simplified province and autonomous community maps from INE. The moveCAN Canary Islands displacement becomes an explicit parameter rather than hidden behavior, and raster plotting is handed off to tidyterra.

    View source ↗
  5. 1y ago

    Comarca types split across four official sources

    A type argument lets esp_get_comarca() return official IGN, statistical INE, agrarian or livestock comarcas — four competing definitions of the same administrative unit, now selectable rather than assumed. Column selection in the SIANE province getter is made more robust.

    View source ↗
  6. 1y ago

    Adapted to the SIANE 2024 databases

    Functions follow SIANE's annual database turnover, with the region-code and translation dictionaries improved alongside. The recurring maintenance tax of wrapping national statistical services.

    View source ↗