rebird (version 1.1.0)

ebirdtaxonomy: eBird Taxonomy

Description

Returns a data.frame of all species in the eBird taxonomy for the given combination of categories. The default category is "species". Any taxon with the category of 'species' may be used as a parameter in service calls that take a scientific name. Any taxon not in this category will be rejected by these services at this time.

Usage

ebirdtaxonomy(cat = NULL, locale = NULL, key = NULL, ...)

Arguments

cat

Species category. String or character vector with one of more of: "domestic", "form", "hybrid", "intergrade", "issf", "slash", "species", "spuh". For more info about the meaning of species categories, see https://help.ebird.org/customer/en/portal/articles/1006825-the-ebird-taxonomy.

locale

Language/locale of response (when translations are available). See http://java.sun.com/javase/6/docs/api/java/util/Locale.html and https://help.ebird.org/customer/portal/articles/1596582-common-name-translations-in-ebird (defaults to en_US).

key

ebird API key. You can obtain one from https://ebird.org/api/keygen. We strongly recommend storing it in your .Renviron file as an environment variable called EBIRD_KEY to avoid having to constantly supply the key, and to avoid accidentally sharing it publicly.

...

Curl options passed on to GET

Value

A data.frame containing the collected information:

"comName": species' common name

"sciName": species' scientific name

"taxonID": Taxonomic Concept identifier, note this is currently in test

References

http://ebird.org/

Examples

# NOT RUN {
ebirdtaxonomy()
ebirdtaxonomy(cat=c("spuh", "slash")) 
# }