taxonsearch: Search for taxa in GBIF.

Description

When searching for taxa, keep in mind that unless you want taxon identifiers for a specific data source, leave dataproviderkey as the default of 1, which is the GBIF backbone taxonomy. Also, always specify the taxonomic rank you are searching for - GBIF says the search is more efficient if rank is given.

Usage

taxonsearch(scientificname = NULL, rank = NULL,
    maxresults = 10, dataproviderkey = 1,
    dataresourcekey = NULL, resourcenetworkkey = NULL,
    hostisocountrycode = NULL, startindex = NULL,
    accepted_status = FALSE)

Arguments

scientificname

scientific name of taxon (character, see example)

rank

rank of taxon, see taxrank() (character)

maxresults

return at most the specified number of records. The default (and maximum supported) is 1000 records.

dataproviderkey

Filter records to those provided by the supplied numeric key for a data provider. See provider(). (character)

dataresourcekey

Filter records to those provided by the supplied numeric key for a data resource See resource(). (character)

resourcenetworkkey

count only records which have been made available by resources identified as belonging to the network identified by the supplied numeric key.

hostisocountrycode

return only records served by providers from the country identified by the supplied 2-letter ISO code.

startindex

return the subset of the matching records that starts at the supplied (zero-based index).

accepted_status

Status in the GIBF portal

Value

A data.frame.

Details

This function is deprecated.

Search for a taxon using scientific name. Optionally, include taxonomic rank in the search. Returns list of TaxonConcept key values.

Examples

Run this code

# Do specify the taxonomic rank the you are searching for, rank of species here
taxonsearch(scientificname = 'Puma concolor', rank="species")

# Fabaceae (rank of genus)
taxonsearch(scientificname = 'Abies', rank="genus")

# Fabaceae (rank of family)
taxonsearch(scientificname = 'Fabaceae', rank="family")