lookup_ipni: Look up a name in IPNI.

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

Look up a name in IPNI.

Description

Request the record for a taxon, author, or publication name in IPNI, using the IPNI ID.

Usage

lookup_ipni(id, type = c("taxon", "author", "publication"), .wait = 0.1)

Arguments

id	A string containing a valid IPNI ID.
type	The type of record to look up. Either taxon, author, or publication.
.wait	Time to wait before making a request, to help rate limiting.

Details

The International Plant Names Index (IPNI) is a service that provides nomenclatural information for vascular plant names.

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

Value

An ipni_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.

See Also

• search_ipni() to search IPNI using a taxon name.

Other IPNI functions: search_ipni()

Examples

# retrieve nomenclatural information for a taxon name
name <- lookup_ipni("271445-2", "taxon")
print(name)

# tidy the results in a table
tidy(name)

# retrieve nomenclatural information for an author
name <- lookup_ipni("20028192-1", type="author")
tidy(name)

# retrieve nomenclatural information for a publication
name <- lookup_ipni("987-2", type="publication")
tidy(name)

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