Skip to contents

vantorr 0.3.0

  • Production of Fieldwork Resources for Survey Data Collection (vantor_fieldwork.R):
    • Survey Index Grids & Enumeration Area Partitioning:
      • Added vantor_survey_grid() to partition an Area of Interest into square or hexagonal enumeration cells with alphanumeric spreadsheet labels ("A1", "A2", "B1", …), WGS84 centroids, and planar area (area_m2).
    • Imagery Vintage & Quality Auditing:
      • Added vantor_vintage_report() to intersect Enumeration Areas or survey grids with OGC WFS seamlines (vantor_get_seamlines()), computing earliest_acq_date, latest_acq_date, max_age_days, min_gsd_m, max_gsd_m, max_ona_deg, contributing sensors, and flagging outdated cells via vintage_warning.
    • CAPI Preload Export & Offline Plus Codes:
      • Added vantor_plus_code() to encode WGS84 coordinates into 8-, 10-, or 11-character Open Location Codes (Google Plus Codes) in pure R for offline navigation.
      • Added vantor_export_capi() to enrich sample points/polygons with odk_geopoint strings, plus_code, google_maps_url, grid cell_id, and imagery vintage metadata, with optional CSV/GeoJSON export (output_csv, output_geojson) for ODK Collect, KoboToolbox, and ArcGIS Survey123, plus native tab-delimited .tab assignment preload export (output_suso_tab, suso_gps_var) for World Bank Survey Solutions.
    • Printable Field Atlases, Esri Tile Packages (.tpk / .tpkx) & Offline Mobile Bundles:
      • Added vantor_field_atlas() to generate multi-page printable PDF Field Atlases (Overview Index sheet + per-cell Detail Enumeration Sheets with scale bars, north arrows, optional Vantor RGB satellite imagery, and enumerator sign-off footers).
      • Added vantor_write_tpk() to generate multi-zoom Web Mercator (EPSG:3857 / WKID: 102100) Esri Tile Packages in pure R—supporting both classic .tpk (Compact Cache V1) and the Apache-2.0 open specification .tpkx (Compact Cache V2), plus clean <stem>_tpk.zip upload archives (zip_for_suso = TRUE)—for zoomable offline basemaps in World Bank Survey Solutions, ArcGIS Field Maps, and Survey123.
      • Added vantor_offline_package() to bundle multi-layer OGC GeoPackages (.gpkg), CAPI preload CSVs and Survey Solutions .tab files, Web Mercator (EPSG:3857) GeoTIFF basemaps, optional .tpk/.tpkx tile pyramids (create_tpk), and zipped Esri Shapefiles (create_shapefiles = TRUE) into a portable directory for Survey Solutions, QField, Mergin Maps, and ArcGIS Field Maps.
    • Documentation:
      • Added vignettes "Producing Fieldwork Resources for Survey Data Collection" (vignettes/fieldwork-survey-resources.Rmd) and "Creating Spatial Resources for World Bank Survey Solutions Fieldwork" (vignettes/survey-solutions-workflow.Rmd, including automated server deployment with SurveySolutionsAPIv2).

vantorr 0.2.0

  • R Shiny Modules, Interactive leaflet Mapping, WFS Seamlines, Usage API & Companion Website:
    • Interactive leaflet Integration (vantor_leaflet.R):
    • Seamlines OGC WFS & Usage API v2 (vantor_seamlines_usage.R):
      • Added vantor_get_seamlines() to fetch basemap seamline polygons and acquisition metadata (acq_time, gsd, sensor, ona, catid) as an sf object via OGC WFS.
      • Added vantor_get_usage() to query the Account Services Usage API (v2/activation/overview, requiring OAuth2 Bearer Token authentication) for account credit limits, remaining quota, and consumption breakdowns.
    • R Shiny Application Modules (vantor_shiny.R, vantor_api_getmap.R):
    • Documentation & Companion Website:
      • Added vignette "Interactive Leaflet Maps and Shiny Apps with vantorr" (vignettes/shiny-leaflet-integration.Rmd).
      • Added pkgdown companion website configuration (_pkgdown.yml) and GitHub Actions deployment workflow (.github/workflows/pkgdown.yaml).

vantorr 0.1.0

  • Initial Release Preparation & Core Refactoring:
    • Authentication & Session Management (vantor_api_gettoken.R):
      • Added vantor_auth(), vantor_has_auth(), and vantor_auth_clear() to manage session credentials via OAuth2 Bearer tokens or API keys (maxar-api-key), with automatic fallback to VANTOR_API_KEY, MAXAR_API_KEY, VANTOR_USERNAME, and VANTOR_PASSWORD environment variables.
      • Added automatic session token caching and transparent refresh before expiration.
      • Updated create_maxar_request() to support both API keys and Bearer tokens, custom user-agent headers, and httr2::req_retry() for transient HTTP errors (429, 500, 502, 503, 504).
    • Spatial Ecosystem Dispatch (spatial_dispatch.R):
      • Added S3 generic vantor_as_bbox() supporting sf (sf, sfc, sfg, bbox), terra (SpatRaster, SpatVector, SpatExtent), stars (stars, stars_proxy), and numeric bounding box vectors with automatic CRS detection and transformation.
      • Added return_type support ("file", "SpatRaster", "stars", "stars_proxy") to get_maxar_wms_basemap() and get_maxar_wms_tiles().
    • WMS Basemap & Tiling (vantor_api_getmap.R):
    • CRAN Repository Policy Compliance:
      • Changed default file/directory output arguments in get_maxar_wms_basemap() and get_maxar_wms_tiles() to use tempfile() so functions never write to the user’s working directory by default.
      • Standardized all messaging on cli and ensured graceful failure (returning invisible(NULL) with an informative message rather than an unhandled error) when internet or API resources are unavailable.
      • Updated DESCRIPTION metadata, Title, Description, URL, BugReports, and Suggests fields to pass R CMD check --as-cran.