Request the record for a taxon, author, or publication name in IPNI, using the IPNI ID.
lookup_ipni(id, type = c("taxon", "author", "publication"), .wait = 0.1)
A string containing a valid IPNI ID.
The type of record to look up. Either taxon
, author
, or publication
.
Time to wait before making a request, to help rate limiting.
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.
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.
search_ipni()
to search IPNI using a taxon name.
Other IPNI functions:
search_ipni()
# retrieve nomenclatural information for a taxon name
name <- lookup_ipni("271445-2", "taxon")
#> No encoding supplied: defaulting to UTF-8.
print(name)
#> <IPNI name id: 271445-2, type: citation>
#> Name: Abbevillea chrysophylla
#> Authors: O.Berg
#> Publication: Fl. Bras. (Martius)
#> Publication Year: 1857
#> Reference: Fl. Bras. (Martius) 14(1): 437. 1857 [15 May 1857]
#> Rank: spec.
#> In POWO: TRUE
# tidy the results in a table
tidy(name)
#> # A tibble: 1 × 39
#> name authors publishingAuthor authorTeam rank url family genus species
#> <chr> <chr> <chr> <list> <chr> <chr> <chr> <chr> <chr>
#> 1 Abbevi… O.Berg O.Berg <tibble [1… spec. /n/27… Myrta… Abbe… chryso…
#> # … with 30 more variables: citationType <chr>, collectionNumber <chr>,
#> # collectorTeam <chr>, distribution <chr>, hybrid <lgl>, hybridGenus <lgl>,
#> # inPowo <lgl>, nomenclaturalSynonym <list>, pageAsText <chr>,
#> # linkedPublication <list>, publication <chr>, publicationYear <int>,
#> # publicationYearNote <chr>, referenceCollation <chr>, publicationId <chr>,
#> # recordType <chr>, reference <chr>, sameCitationAs <list>, suppressed <lgl>,
#> # topCopy <lgl>, typeLocations <chr>, version <chr>, parent <list>, …
# retrieve nomenclatural information for an author
name <- lookup_ipni("20028192-1", type="author")
#> No encoding supplied: defaulting to UTF-8.
tidy(name)
#> # A tibble: 1 × 16
#> alternativeNames dates examples forename fqId id isoCountries recordType
#> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
#> 1 "" fl. 2… Schnella… Liam A. urn:… 2002… "" author
#> # … with 8 more variables: standardForm <chr>, surname <chr>, suppressed <lgl>,
#> # taxonGroups <chr>, url <chr>, version <chr>, summary <chr>,
#> # hasBhlLink <lgl>
# retrieve nomenclatural information for a publication
name <- lookup_ipni("987-2", type="publication")
#> No encoding supplied: defaulting to UTF-8.
tidy(name)
#> # A tibble: 1 × 15
#> abbreviation bphNumber date fqId id lcNumber precededBy recordType
#> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
#> 1 Kew Bull. 513.05 Vol. … urn:lsi… 987-2 QK1.K45 Bull. Misc. … publicati…
#> # … with 7 more variables: suppressed <lgl>, title <chr>, url <chr>,
#> # version <chr>, hasBhlLinks <lgl>, hasBhlTitleLink <lgl>,
#> # hasBhlPageLink <lgl>