ecoengine (version 1.3)

ee_observations: Observations List

Description

API endpoint that represents a list of observations.

Usage

ee_observations(page = NULL, page_size = 25, country = "United States",
  state_province = NULL, county = NULL, kingdom = NULL, phylum = NULL,
  order = NULL, clss = NULL, family = NULL, genus = NULL,
  scientific_name = NULL, kingdom__exact = NULL, phylum__exact = NULL,
  order__exact = NULL, clss__exact = NULL, family__exact = NULL,
  genus__exact = NULL, scientific_name__exact = NULL, remote_id = NULL,
  collection_code = NULL, source = NULL, min_date = NULL,
  max_date = NULL, georeferenced = FALSE, bbox = NULL, quiet = FALSE,
  progress = TRUE, foptions = list())

Arguments

page

Page number

page_size

The number of observations per page returned by the query. The package default is 25 observations. The API default, however, is 10. Setting this number higher will require fewer calls (i.e. pages) but a large size may also fail o

country

country name

state_province

description needed.

county

California county. See data(california_counties)

kingdom

kingdom name

phylum

phylum name

order

order name

clss

class name

family

family name

genus

genus name.

scientific_name

A full scientific name

kingdom__exact

exact kingdom name

phylum__exact

exact phylum name

order__exact

exact order name

clss__exact

class name

family__exact

exact family name

genus__exact

exact genus name

scientific_name__exact

exact scientific name

remote_id

remote ID

collection_code

collections code

source

data source. See ee_sources

min_date

Lower date bound. Most be in format Y-m-D h:m:s. This package uses lubridate's ymd_hms function to format dates.

max_date

upper date bound. Most be in format Y-m-D h:m:s. This package uses lubridate's ymd_hms function to format dates.

georeferenced

Default is FALSE. Set to TRUE to return only georeferenced records.

bbox

Set a bounding box for your search. Use format bbox=-124,32,-114,42. Order is min Longitude , min Latitude , max Longitude , max Latitude. Use http://boundingbox.klokantech.com/ this website to quickly grab a bounding box (set fo

quiet

Default is FALSE. Set to TRUE to supress messages.

foptions

A list of additional arguments for httr. There is no reason to use this argument except for debugging purposes.

progress

Progress bar is set to TRUE by default. Use FALSE especially when calling functions inside documents.

Value

• data.frame

Examples

vulpes <- ee_observations(genus = "vulpes")
pinus <- ee_observations(scientific_name = "Pinus")
lynx_data <- ee_observations(genus = "Lynx")
# Georeferenced data only
lynx_data <- ee_observations(genus = "Lynx", georeferenced = TRUE)
animalia <- ee_observations(kingdom = "Animalia")
Artemisia <- ee_observations(scientific_name = "Artemisia douglasiana")
asteraceae <- ee_observationss(family = "asteraceae")
vulpes <- ee_observations(genus = "vulpes")
Anas <- ee_observations(scientific_name = "Anas cyanoptera", page = "all")
loons <- ee_observations(scientific_name = "Gavia immer", page = "all")
plantae <- ee_observations(kingdom = "plantae")
chordata <- ee_observations(phylum = "chordata")
# Class is clss since the former is a reserved keyword in SQL.
aves <- ee_observations(clss = "aves")
aves <- ee_observations(clss = "aves", bbox = '-124,32,-114,42')
aves <- ee_observations(clss = "aves", county = "Alameda county")