natserv (version 0.4.0)

ns_search: NatureServe taxonomic name search

Description

NatureServe taxonomic name search

Usage

ns_search(x, key = NULL, ...)

Arguments

x

(character) A name to search for. An asterisk () wildcarded species name, e.g., 'Aquila chry'. Name matching is case-insensitive and all of the primary and synonymous scientific names, along with all common names, are matched. required.

key

(character) API key. Required. See Authentication below for more.

...

Curl options passed on to HttpClient

Value

A tibble (data.frame), with columns:

• jurisdictionScientificName - Scientfic name

• commonName - Common name

• globalSpeciesUid - UID - the taxonomic identifier NatureServe uses

• natureServeExplorerURI - URL to get to info online for the taxon

• taxonomicComments - comments about the taxon, if any

Authentication

Get an API key from NatureServe at https://services.natureserve.org/developer/index.jsp. You can pass your token in as an argument or store it one of two places:

• your .Rprofile file with an entry like options(NatureServeKey = "your-natureserve-key")

• your .Renviron file with an entry like NATURE_SERVE_KEY=your-natureserve-key

See Startup for information on how to create/find your .Rrofile and .Renviron files

References

https://services.natureserve.org/index.jsp

Examples

# NOT RUN {
ns_search(x = "Ruby*")
ns_search(x = "Helianthus annuus")
ns_search(x = "Ursus americanus")
# }