Get number of occurrence records.

occ_count(taxonKey = NULL, georeferenced = NULL,
  basisOfRecord = NULL, datasetKey = NULL, date = NULL,
  typeStatus = NULL, country = NULL, year = NULL, from = 2000,
  to = 2012, type = "count", publishingCountry = "US",
  protocol = NULL, curlopts = list())

Arguments

taxonKey

Species key

georeferenced

Return only occurrence records with lat/long data (TRUE) or those that don't have that data (FALSE, default). Note that you can also get record count with occ_search() by setting limit=0

basisOfRecord

Basis of record

datasetKey

Dataset key

date

Collection date

typeStatus

A type status. See typestatus() dataset for options

country

Country data was collected in, two letter abbreviation. See http://countrycode.org/ for abbreviations.

year

Year data were collected in

from

Year to start at

to

Year to end at

type

One of count (default), schema, basis_of_record, countries, or year.

publishingCountry

Publishing country, two letter ISO country code

protocol

Protocol. E.g., 'DWC_ARCHIVE'

curlopts

list of named curl options passed on to HttpClient. see curl_options for curl options

Value

A single numeric value, or a list of numerics.

Details

There is a slight difference in the way records are counted here vs. results from occ_search(). For equivalent outcomes, in the occ_search() function use hasCoordinate=TRUE, and hasGeospatialIssue=FALSE to have the same outcome for this function using georeferenced=TRUE.

Supported dimensions

That is, there are only a certain set of supported query parameter combinations that GBIF allows on this API route. They can be found with the call occ_count(type='schema'). They are also presented below:

  • basisOfRecord

  • basisOfRecord, country

  • basisOfRecord, country, isGeoreferenced

  • basisOfRecord, country, isGeoreferenced, taxonKey

  • basisOfRecord, country, taxonKey

  • basisOfRecord, datasetKey

  • basisOfRecord, datasetKey, isGeoreferenced

  • basisOfRecord, datasetKey, isGeoreferenced, taxonKey

  • basisOfRecord, datasetKey, taxonKey

  • basisOfRecord, isGeoreferenced, taxonKey

  • basisOfRecord, isGeoreferenced, publishingCountry

  • basisOfRecord, isGeoreferenced, publishingCountry, taxonKey

  • basisOfRecord, publishingCountry

  • basisOfRecord, publishingCountry, taxonKey

  • basisOfRecord, taxonKey

  • country

  • country, datasetKey, isGeoreferenced

  • country, isGeoreferenced

  • country, isGeoreferenced, publishingCountry

  • country, isGeoreferenced, taxonKey

  • country, publishingCountry

  • country, taxonKey

  • country, typeStatus

  • datasetKey

  • datasetKey, isGeoreferenced

  • datasetKey, isGeoreferenced, taxonKey

  • datasetKey, issue

  • datasetKey, taxonKey

  • datasetKey, typeStatus

  • isGeoreferenced

  • isGeoreferenced, publishingCountry

  • isGeoreferenced, publishingCountry, taxonKey

  • isGeoreferenced, taxonKey

  • issue

  • publishingCountry

  • publishingCountry, taxonKey

  • publishingCountry, typeStatus

  • taxonKey

  • taxonKey, typeStatus

  • typeStatus

  • protocol

  • year

References

http://www.gbif.org/developer/occurrence#metrics

Examples

# NOT RUN {
occ_count(basisOfRecord='OBSERVATION')
occ_count(georeferenced=TRUE)
occ_count(country='DE')
occ_count(country='CA', georeferenced=TRUE, basisOfRecord='OBSERVATION')
occ_count(datasetKey='9e7ea106-0bf8-4087-bb61-dfe4f29e0f17')
occ_count(year=2012)
occ_count(taxonKey=2435099)
occ_count(taxonKey=2435099, georeferenced=TRUE)
occ_count(protocol='DWC_ARCHIVE')

# Just schema
occ_count(type='schema')

# Counts by basisOfRecord types
occ_count(type='basisOfRecord')

# Counts by basisOfRecord types
occ_count(typeStatus='ALLOTYPE')
occ_count(typeStatus='HOLOTYPE')

# Counts by countries. publishingCountry must be supplied (default to US)
occ_count(type='countries')

# Counts by year. from and to years have to be supplied, default to 2000
# and 2012
occ_count(type='year', from=2000, to=2012)

# Counts by publishingCountry, must supply a country (default to US)
occ_count(type='publishingCountry')
occ_count(type='publishingCountry', country='BZ')

# Pass on curl options
occ_count(type='year', from=2000, to=2012, curlopts = list(verbose = TRUE))
# }