get_ilter_generalinfo: Download information of all ILTER sites or a subset of ILTER...
In oggioniale/ReLTER: An Interface for the eLTER Community

get_ilter_generalinfo

R Documentation

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

Description

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

Author(s)

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

References

\insertRef

jsonliteRReLTER

\insertRef

sfRReLTER

\insertRef

leafletRReLTER

Examples

## Not run: 
# 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
)

## End(Not run)

oggioniale/ReLTER documentation built on Jan. 4, 2024, 3:48 p.m.