Skip to contents

Download information of all ILTER sites or a subset of ILTER sites.

Source: R/get_ilter_generalinfo.R
get_ilter_generalinfo.Rd

[Questioning] This function downloads generic information of sites of ILTER sites (more than 1200 around the world), through the DEIMS-SDR API. Return a tibble object.

Usage

get_ilter_generalinfo(country_name = NA, site_name = NA, show_map = FALSE)

Arguments

country_name

A character. Country name (complete name in English, French, Italian, German, OR 2 character ISO code) of DEIMS sites to retrieve. Partial matching of country names is NOT supported.

site_name

A character. This character string filters by site name where partial matching is supported. At least one of country_name or site_name must be specified

show_map

A boolean. If TRUE a Leaflet map of site locations is shown. Default FALSE

Value

An sf object of the bounding boxes of sites in the filtered list, containing the name, DEIMS ID, longitude, latitude, average altitude, and affiliation of the filtered ILTER sites. If no bounding box is available,the centroid is returned.

Note

at least one of country_name or site_name must be specified

References

Ooms J (2014). “The jsonlite Package: A Practical and Consistent Mapping Between JSON Data and R Objects.” arXiv:1403.2805 [stat.CO]. https://arxiv.org/abs/1403.2805.

Pebesma E (2018). “Simple Features for R: Standardized Support for Spatial Vector Data.” The R Journal, 10(1), 439--446. doi: 10.32614/RJ-2018-009 .

Cheng J, Karambelkar B, Xie Y (2022). leaflet: Create Interactive Web Maps with the JavaScript 'Leaflet' Library. R package version 2.1.1, https://CRAN.R-project.org/package=leaflet.

Author

Alessandro Oggioni, phD (2021) oggioni.a@irea.cnr.it

Micha Silver, phD (2021) silverm@post.bgu.ac.il

Paolo Tagliolato, phD (2023) tagliolato.p@irea.cnr.it

Examples

if (FALSE) {
# list of the all sites info with ILTER
listOfAllSites <- get_ilter_generalinfo()
length(listOfAllSites[,1])

# example about country name parameter
sitesAustria <- get_ilter_generalinfo(country_name = "Austri")
# (matches Austria, but not Australia)
length(sitesAustria$title)

# example of single site in a country
eisenwurzen <- get_ilter_generalinfo(
  country_name = "Austri",
  site_name = "Eisen"
)
eisenwurzen[,1:2]
# extract DEIMS.Id
eisenwurzen_deimsid <- eisenwurzen$uri
eisenwurzen_deimsid

# example of single site in a country and return only map
get_ilter_generalinfo(
  country_name = "Italy",
  site_name = "Maggiore",
  show_map = TRUE
)
}