Add Address API support

CITATION.cff

@@ -97,6 +97,21 @@ references:
     email: [email protected]
   year: '2024'
   version: '>= 2.0.0'
+- type: software
+  title: jsonlite
+  abstract: 'jsonlite: A Simple and Robust JSON Parser and Generator for R'
+  notes: Imports
+  url: https://jeroen.r-universe.dev/jsonlite
+  repository: https://CRAN.R-project.org/package=jsonlite
+  authors:
+  - family-names: Ooms
+    given-names: Jeroen
+    email: [email protected]
+    orcid: https://orcid.org/0000-0002-4035-0289
+  year: '2024'
+  identifiers:
+  - type: url
+    value: https://arxiv.org/abs/1403.2805
 - type: software
   title: rappdirs
   abstract: 'rappdirs: Application Directories: Determine Where to Save Data, Caches,

DESCRIPTION

@@ -24,6 +24,7 @@ Depends:
 Imports: 
     countrycode (>= 1.2.0),
     geojsonsf (>= 2.0.0),
+    jsonlite,
     rappdirs (>= 0.3.0),
     sf (>= 0.9.0),
     utils

NAMESPACE

@@ -1,5 +1,15 @@
 # Generated by roxygen2: do not edit by hand
 
+export(gisco_addressapi_bbox)
+export(gisco_addressapi_cities)
+export(gisco_addressapi_copyright)
+export(gisco_addressapi_countries)
+export(gisco_addressapi_housenumbers)
+export(gisco_addressapi_postcodes)
+export(gisco_addressapi_provinces)
+export(gisco_addressapi_reverse)
+export(gisco_addressapi_roads)
+export(gisco_addressapi_search)
 export(gisco_attributions)
 export(gisco_bulk_download)
 export(gisco_check_access)
@@ -19,6 +29,7 @@ export(gisco_get_postalcodes)
 export(gisco_get_units)
 export(gisco_get_urban_audit)
 export(gisco_set_cache_dir)
+importFrom(utils,URLencode)
 importFrom(utils,download.file)
 importFrom(utils,menu)
 importFrom(utils,read.csv2)

NEWS.md

@@ -2,6 +2,10 @@
 
 -   New functions:
     -   `gisco_get_education()`.
+    -   Add access to [GISCO Address
+        API](https://gisco-services.ec.europa.eu/addressapi/docs/screen/home)
+        through new functions. See `?gisco_addressapi` to know more (#84).
+-   New dependency: **jsonlite** added to 'Imports'.
 -   Update `gisco_db` with the most up-to-date released data.
 -   Default year of some functions updated to the latest available data:
     -   `gisco_get_lau()` and `gisco_get_urban_audit()` default year now is
@@ -30,7 +34,7 @@
 
 # giscoR 0.3.5
 
--   Review examples to avoid CRAN errors and notes.
+-   Review examples to avoid **CRAN** errors and notes.
 -   New helper function: `gisco_detect_cache_dir()`.
 -   Now the functions fail gracefully with an informative message, instead of an
     error, and return `NULL`.
@@ -45,12 +49,12 @@
 
 # giscoR 0.3.2
 
--   Fix HTML5 issue as requested by CRAN.
+-   Fix HTML5 issue as requested by **CRAN**.
 
 # giscoR 0.3.1
 
--   Add `Copyright` on DESCRIPTION.
--   Add `lwgeom` on `Suggests`.
+-   Add `Copyright` on `DESCRIPTION`.
+-   Add **lwgeom** on 'Suggests'.
 -   `gisco_get_airports()` and `gisco_get_ports()`:
     -   Only year available is 2013.
     -   Now information is downloaded instead of using internal data.
@@ -67,22 +71,22 @@
     `gisco_clear_cache()`.
 -   Fix an error when `cache = FALSE`. Now files are loaded instead throwing an
     error.
--   New tests with `testthat`.
+-   New tests with **testthat**.
 -   Update on docs. New examples
 -   Refactor documents and codes for the previous `gisco_get` doc.
--   Add `eurostat` package to `Suggests`.
--   `lwgeom` dependency removed.
+-   Add **eurostat** package to ' Suggests'.
+-   **lwgeom** dependency removed.
 -   Update internal grid object.
--   `tmap` package replaced by `ggplot2` on vignettes and examples.
+-   **tmap** package replaced by **ggplot2** on vignettes and examples.
 
 # giscoR 0.2.4
 
 -   New `eu` field on `giscoR::gisco_countrycode`.
--   Fix typos on documentation
--   Include vignette on the package
--   Move docs to `roxygen2`
--   `lwgeom` moved to Import field.
--   `cartography` package replaced by `tmap` on vignettes.
+-   Fix typos on documentation.
+-   Include vignette on the package.
+-   Move docs to **roxygen2**.
+-   **lwgeom** moved to 'Imports' field.
+-   **cartography** package replaced by **tmap** on vignettes.
 
 # giscoR 0.2.3
 
@@ -95,14 +99,14 @@
 
 # giscoR 0.2.1
 
--   Remove CRAN notes.
+-   Remove **CRAN** notes.
 -   Improve docs.
--   Fix CRAN checks.
+-   Fix **CRAN** checks.
 
 # giscoR 0.2.0
 
--   Remove `colorspace` as dependency.
--   Bump R minimal version to 3.6.0.
+-   Remove **colorspace** as dependency.
+-   Bump **R** minimal version to `3.6.0`.
 -   Change order on parameters for `gisco_get()` functions.
 -   Rewriting of internal functions and utils.
 -   Add `verbose` parameter to functions.
@@ -120,7 +124,7 @@
 # giscoR 0.1.1
 
 -   Added `giscoR::tgs00026` dataset.
--   Remove `eurostat` dependency.
+-   Remove **eurostat** dependency.
 
 # giscoR 0.1.0
 

R/giscoR-package.R

@@ -2,5 +2,5 @@
 "_PACKAGE"
 
 # import stuffs
-#' @importFrom utils download.file unzip read.csv2 menu
+#' @importFrom utils download.file unzip read.csv2 menu URLencode
 NULL