occCite (version 0.6.0)

getGBIFpoints: Download occurrences from GBIF

Description

Downloads GBIF occurrence points and useful related information for processing within other occCite functions

Usage

getGBIFpoints(
  taxon,
  GBIFLogin = GBIFLogin,
  GBIFDownloadDirectory = NULL,
  checkPreviousGBIFDownload = T
)

Value

A list containing

1. a data frame of occurrence data;

2. GBIF search metadata;

3. a data frame containing the raw results of a query to `rgbif::occ_download_get()`.

Arguments

taxon

A string with a single species name

GBIFLogin

An object of class GBIFLogin to log in to GBIF to begin the download.

GBIFDownloadDirectory

An optional argument that specifies the local directory where GBIF downloads will be saved. If this is not specified, the downloads will be saved to your current working directory.

checkPreviousGBIFDownload

A logical operator specifying whether the user wishes to check their existing prepared downloads on the GBIF website.

Details

`getGBIFpoints` only returns records from GBIF that have coordinates, aren't flagged as having geospatial issues, and have an occurrence status flagged as "PRESENT".

Examples

if (FALSE) {
getGBIFpoints(
  taxon = "Gadus morhua",
  GBIFLogin = myGBIFLogin,
  GBIFDownloadDirectory = NULL
)
}