Skip to contents

Retrieve reusable, phylogenetically diverse and representative images for a set of Open Tree of Life IDs.

Usage

node_images(otts, type = "any", rate = 5, key = NA, basereq = NA)

Arguments

otts

a numeric ID or numeric vector of ott ids indicating the particular taxa to evaluate.

type

whether to return any representative images, only images that have been verified as correctly identified, or only public domain images. Defaults to "any".

rate

maximum number of calls to the API per second.

key

your OneZoom API key (defaults to the public key of 0 if not specified).

basereq

an httr2 request object, as generated by oz_basereq(). If NA, uses the default request.

Value

A data frame of the output image locations, names, identifiers and their usage rights.

Types

The following types valid options for the type argument:

  • "any" - any images

  • "verified" - images verified as correctly identified

  • "pd" - images explicitly in the public domain

Author

Francis Windram

Examples

if (FALSE) { # \dontrun{
node_images(247341)

node_images(c(247341, 563159, 269666, 504327, 668392), rate=5)

node_images(c(247341, 563159, 269666, 504327, 668392), type="pd")
} # }