R: NatureServe taxonomic name search

ns_search {natserv} | R Documentation

## 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 `GET`

### 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")

    ## End(Not run)

[Package natserv version 0.1.4 Index]