Lookup names in the GBIF backbone taxonomy.
name_backbone(name, rank = NULL, kingdom = NULL, phylum = NULL, class = NULL, order = NULL, family = NULL, genus = NULL, strict = FALSE, verbose = FALSE, start = NULL, limit = 100, curlopts = list())
name | (character) Full scientific name potentially with authorship (required) |
---|---|
rank | (character) The rank given as our rank enum. (optional) |
kingdom | (character) If provided default matching will also try to match against this if no direct match is found for the name alone. (optional) |
phylum | (character) If provided default matching will also try to match against this if no direct match is found for the name alone. (optional) |
class | (character) If provided default matching will also try to match against this if no direct match is found for the name alone. (optional) |
order | (character) If provided default matching will also try to match against this if no direct match is found for the name alone. (optional) |
family | (character) If provided default matching will also try to match against this if no direct match is found for the name alone. (optional) |
genus | (character) If provided default matching will also try to match against this if no direct match is found for the name alone. (optional) |
strict | (logical) If |
verbose | (logical) If |
start | Record number to start at. Default: 0. Use in combination
with |
limit | Number of records to return. Default: 100. Maximum: 1000. |
curlopts | list of named curl options passed on to
|
A list for a single taxon with many slots (with verbose=FALSE
)
default), or a list of length two, first element for the suggested taxon
match, and a data.frame with alternative name suggestions resulting from
fuzzy matching (with verbose=TRUE
).
If you don't get a match GBIF gives back a list of length 3 with slots synonym, confidence, and matchType='NONE'.
http://www.gbif.org/developer/species#searching
# NOT RUN { name_backbone(name='Helianthus annuus', kingdom='plants') name_backbone(name='Helianthus', rank='genus', kingdom='plants') name_backbone(name='Poa', rank='genus', family='Poaceae') # Verbose - gives back alternatives name_backbone(name='Helianthus annuus', kingdom='plants', verbose=TRUE) # Strictness name_backbone(name='Poa', kingdom='plants', verbose=TRUE, strict=FALSE) name_backbone(name='Helianthus annuus', kingdom='plants', verbose=TRUE, strict=TRUE) # Non-existent name - returns list of lenght 3 stating no match name_backbone(name='Aso') name_backbone(name='Oenante') # Pass on curl options name_backbone(name='Oenante', curlopts = list(verbose=TRUE)) # }