country_species_list: Get species list for a country

In ropensci/rdopa: R client to Joint Research Centre's DOPA REST API

Get species list for a country

Description

Returns a list of the species whose range intersects with the country. This intersection on the species range includes the Exclusive Economic Zone boundary for the country which extends out to 200 nautical miles from the coastline. The EEZ boundary was derived from the Flanders Marine Institute (see here for more information).

Usage

country_species_list(country, status = NULL, cache = TRUE)

Arguments

country	Character country name or numeric country code.
status	A character vector of the IUCN Conservation Status for the species. Default is NULL in which case species of all statuses are requested. For more information see here.
cache	Sets the cache mode: TRUE = Use cache if available and save to cache, FALSE = Ignore cache if available and do not save to cache, "flush" = Ignore cache if available and save to cache.

Value

A data.frame of species whose range intersects with the country. Each species has the following information associated to it:

iucn_species_id	IUCN Species Identifier from the Red List website. To find the IUCN Species Identifier, search for a species and then look for the number in the URL, e.g. Orang Utan is 17975
taxon	The taxonomic name for the species
kingdom	The kingdom for the species
phylum	The phylum for the species
class	The class for the species
order	The order for the species
family	The family for the species
status	The IUCN Conservation Status for the species according to the following values: CR-Critically Endangered, EN-Endangered, VU-Vulnerable, NT-Near Threatened, LC-Least Concern, EX-Extinct, EW-Extinct in the Wild, DD-Data Deficient. For more information see here
commonname	No description
language	No description
country_id	Country ISO code
country_name	Country name

Author(s)

Joona Lehtomaki <[e-mail]>

See Also

http://dopa-services.jrc.ec.europa.eu/services/ibex/especies/get_country_species_list

resolve_country check_iucn_status

Examples

## Not run: 
# Get species for New Zealand
kiwi.species <- country_species_list(country="New Zealand")

# Get only endangered species for New Zealand
endangered.kiwi.species <- country_species_list(country="New Zealand",
                                                rlstatus=c("CR", "EN", "VU"))
 

## End(Not run)

ropensci/rdopa documentation built on May 18, 2022, 6:32 p.m.