rvertnet (version 0.0-5)

vertproviders: Retrieve institution and the number of occurences served by institution from VertNet v2 portals.

Description

Retrieve institution and the number of occurences served by institution from VertNet v2 portals.

Usage

vertproviders(key = "r_B68F3", grp = "fish", t = NULL,
    l = NULL, c = NULL, d = NULL, q = NULL, p = NULL,
    m = NULL, url = NULL)

Arguments

key

API Key is required to run any query

grp

VertNet group to query. Currently available oprions fish, bird and herp. Default fish.

t

Taxon scientific and family names. It supports the 'OR' operator.

l

Location country, continent, county, ocean, island, state, province and locality. It supports the 'OR' operator.

c

Catalog Number and/or Institution Code. It supports the 'OR' operator.

d

Year or years the occurrence was collected. Date Ranges must be in yyyy-yyyy format.

q

Terms of interest that may be in the remarks, notes, scientific name, collector, preparation type, location fields or elsewhere in the occurrence. It supports the 'OR' operator.

p

Geometric query in well-known text (WKT) format. Limited to 250 vertices or 10,000 characters. Note that the Map parameter and the Geometry paramter are mutually exclusive. If both are submitted, the Map parameter will be ignored.

m

Geographic area defined by one of the available maps. Maps are designated by MapIDs ref AvailableMaps function

url

The VertNet url for the function (should be left to default).

Value

• Dataframe of search results OR prints "No records found" if no matches.

Examples

# Taxon
vertproviders(t="notropis")
vertproviders(t="notropis or nezumia")
vertproviders(t="Blenniidae")

# Location
vertproviders(l="country:canada")
vertproviders(l="alabama or gulf of mexico")
vertproviders(l="africa",grp="bird")

# Catalog Number/Institution Code
vertproviders(c="TU 1")
vertproviders(c="mnhn or usnm")
vertproviders(c="ku 29288 or tu 66762")

# Date Range
vertproviders(d="2000-2000")
vertproviders(d="1950-1975")

# Other keywords
vertproviders(q="larva")
vertproviders(q="ethanol or EtOH")

# Geometry
vertproviders(p="POLYGON((-93.998292265615 32.615318339629,-92.471192656236 32.606063985828,-92.635987578112 31.235349580893,-90.988038359361 31.19776691287,-90.955079374988 30.395621231989,-93.94336062499 30.386144489302,-93.998292265615 32.615318339629))")

# Map
vertproviders(m=14)

# Wrong name
vertproviders(t="notropisz")