lookup_wcvp: Look up a taxon in WCVP.

In barnabywalker/kewr: R Package to Access Kew Data APIs

Look up a taxon in WCVP.

Description

Request the record for a taxon in the World Checklist of Vascular Plants (WCVP) using the IPNI ID.

Usage

lookup_wcvp(taxonid, .wait = 0.1)

Arguments

taxonid	A string containing a valid IPNI ID.
.wait	Time to wait before making a request, to help rate limiting.

Details

The World Checklist of Vascular Plants (WCVP) is a global consensus view of all known vascular plant species. It has been compiled by staff at RBG Kew in consultation with plant group experts.

The taxon lookup API allows users to retrieve taxonomic information for a specific taxon name using the unique IPNI ID. If this is not known, it can be found out using the WCVP search API.

Value

A wcvp_taxon object, which is a simple structure with fields for each of the fields returned by the lookup API, as well as the the httr response object.

References

WCVP (2020). World Checklist of Vascular Plants, version 2.0. Facilitated by the Royal Botanic Gardens, Kew. Published on the Internet; http://wcvp.science.kew.org/

See Also

• search_wcvp() to search WCVP using a taxon name.

• download_wcvp() to download the entire WCVP.

Other WCVP functions: download_wcvp(), search_wcvp()

Examples

# retrieve taxonomic information for a taxon name
lookup_wcvp("271445-2")

# print a summary of the returned information
r <- lookup_wcvp("271445-2")
print(r)

# tidy into a tibble
r <- lookup_wcvp("271445-2")
tidy(r)

# tidy the returned list of synonyms into a tibble
r <- lookup_wcvp("60447743-2")
tidied <- tidy(r)
tidyr::unnest(tidied, cols=synonyms, names_sep="_")

# expand the child entries returned for each entry
r <- lookup_wcvp("30000055-2")
tidied <- tidy(r)
tidyr::unnest(tidied, cols=children, names_sep="_")

barnabywalker/kewr documentation built on July 5, 2022, 5:37 p.m.