Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!
Get Started for Free

gni_search

Search for taxonomic names using the Global Names Index


Description

Uses the Global Names Index, see http://gni.globalnames.org

Usage

gni_search(
  sci,
  per_page = NULL,
  page = NULL,
  justtotal = FALSE,
  parse_names = FALSE,
  search_term = NULL,
  ...
)

Arguments

sci

(character) required. Name pattern you want to search for. WARNING: Does not work for common names. Search term may include following options (Note: can, uni, gen, sp, ssp, au, yr work only for parsed names)

  • * wild card - Search by part of a word (E.g.: planta*)

  • exact exact match - Search for exact match of a literal string (E.g.: exact:Parus major)

  • ns name string- Search for literal string from its beginning (other modifiers will be ignored) (E.g.: ns:parus maj*)

  • can canonical form- Search name without authors (other modifiers will be ignored) (E.g.: can:parus major)

  • uni uninomial- Search for higher taxa (E.g.: uni:parus)

  • gen genus - Search by genus epithet of species name (E.g.: gen:parus)

  • sp species - Search by species epithet (E.g.: sp:major)

  • ssp subspecies - Search by infraspecies epithet (E.g.: ssp:major)

  • au author - Search by author word (E.g.: au:Shipunov)

  • yr year - Search by year (E.g.: yr:2005)

per_page

Number of items per one page (numbers larger than 1000 will be decreased to 1000) (default is 30).

page

Page number you want to see (default is 1).

justtotal

Return only the total results found.

parse_names

If TRUE, use gni_parse() to parse names. Default: FALSE

search_term

Deprecated, see sci

...

Curl options passed on to crul::verb-GET

Details

Note that you can use fuzzy searching, e.g., by attaching an asterisk to the end of a search term. See the first two examples below

Value

data.frame of results.

Author(s)

Scott Chamberlain

References

http://gni.globalnames.org/ https://github.com/dimus/gni/wiki/api

See Also

Examples

## Not run: 
gni_search(sci = "ani*")
gni_search(sci = "ama*", per_page = 3, page = 21)
gni_search(sci = "animalia", per_page = 8, page = 1)
gni_search(sci = "animalia", per_page = 8, page = 1, justtotal=TRUE)

gni_search(sci = "Cyanistes caeruleus", parse_names=TRUE)

# pass on curl options
gni_search(sci = "ani*", verbose = TRUE)

## End(Not run)

taxize

Taxonomic Information from Around the Web

v0.9.100
MIT + file LICENSE
Authors
Scott Chamberlain [aut] (<https://orcid.org/0000-0003-1444-9135>), Eduard Szoecs [aut], Zachary Foster [aut, cre], Zebulun Arendsee [aut], Carl Boettiger [ctb], Karthik Ram [ctb], Ignasi Bartomeus [ctb], John Baumgartner [ctb], James O'Donnell [ctb], Jari Oksanen [ctb], Bastian Greshake Tzovaras [ctb], Philippe Marchand [ctb], Vinh Tran [ctb], Maëlle Salmon [ctb], Gaopeng Li [ctb], Matthias Grenié [ctb], rOpenSci [fnd] (https://ropensci.org/)
Initial release

We don't support your browser anymore

Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.