rvertnet (version 0.3.0)

vertsearch: Find records using a global full-text search of VertNet archives.

Description

Returns any record containing your target text in any field of the record.

Usage

vertsearch(taxon = NULL, ..., limit = 1000, compact = TRUE,
  verbose = TRUE)

Arguments

taxon

(character) Taxonomic identifier or other text to search for

...

(character) Additional search terms

limit

(numeric) Limit on the number of records returned. Up to 1000. We'll incorporate paging later for higher limits. See bigsearch to get larger result sets in a text file via email.

compact

Return a compact data frame (boolean)

verbose

Print progress and information messages. Default: TRUE

Value

• A data frame of search results

Details

vertsearch performs a nonspecific search for your input within every record and field of the VertNet archives. For a more specific search, try searchbyterm

References

https://github.com/VertNet/webapp/wiki/The-API-search-function

Examples

out <- vertsearch(taxon = "aves", state = "california", limit=10)

# Limit the number of records returned (under 1000)
out <- vertsearch("(kansas state OR KSU)", limit = 200)
# Use bigsearch() to retrieve >1000 records

# Find multiple species using searchbyterm():
# a) returns a specific result
out <- searchbyterm(gen = "mustela", sp = "(nivalis OR erminea)")
vertmap(out)

# b) returns a non-specific result
out <- vertsearch(tax = "(mustela nivalis OR mustela erminea)")
vertmap(out)

# c) returns a non-specific result
splist <- c("mustela nivalis", "mustela erminea")
out <- lapply(splist, function(x) vertsearch(t=x, lim=500))
library("plyr")
out <- ldply(lapply(out, "[[", "data"))
vertmap(out)