Get occurrence data from GBIF

Use rgbif to retrieve occurrence data from GBIF's database for a given taxon. This function will only return occurrences that include GPS coordinates.

Usage

get_data(key, limit = 100, geometry = NULL)

Arguments

key

The taxon key for the taxon of interest (can be found using SSARP::getKey)

limit

The maximum number of occurrence records to return. Default: 100. NOTE: there is a hard maximum of 100,000 (see more information about the limit in rgbif::occ_search())

geometry

A counter-clockwise winding order well-known text (WKT) representation of geometry for use in the rgbif::occ_search() call. This parameter will restrict returned occurrence records to the specified geometry. More information about valid WKT objects can be found in the rgbif::occ_search() vignette.

Value

A dataframe of occurrence records for the taxon of interest

Examples

# The GBIF key for the Anolis genus is 8782549
#  Obtained with: key <- get_key(query = "Anolis", rank = "genus")
key <- 8782549
# In order to prevent GBIF API calls when running examples, the example 
#  dataset is read here. 
# Normally, a user would run: dat <- get_data(key = key, limit = 100)
dat <- read.csv(system.file("extdata",
                            "SSARP_Example_Dat.csv",
                            package = "SSARP"))

# An example with geometry that restricts returned Anolis data to a box 
#  around Florida (Includes some records in Georgia and the Biminis due  
#  to the size of the square)
# dat <- get_data(key = 8782549, 
#              limit = 1000, 
#              geometry = 'POLYGON((-87.4 24.3, -79.2 24.3, -79.2 31.1,
#              -87.4 31.1, -87.4 24.3))')