Retrieve a list of taxa matching a search query, within a spatial search area, or both.
specieslist(taxon, wkt, fq)
taxon | string: (optional) query of the form field:value (e.g.
"genus:Heleioporus") or a free text search (e.g. "macropodidae").
For reliable results it is recommended to use a specific field where
possible (see |
---|---|
wkt | string: WKT (well-known text) defining a polygon within which to limit taxon search, e.g. "POLYGON((140 -37,151 -37,151 -26,140 -26,140 -37))" |
fq | string: character string or vector of strings, specifying filters
to be applied to the original query. These are of the form
"INDEXEDFIELD:VALUE" e.g. "kingdom:Fungi". See
|
data frame of results, where each row is a taxon, its classification information, and its occurrence count
NOTE March 2017: the response object might include records with missing taxonomic information. This is an issue with the ALA server-side systems; see https://github.com/AtlasOfLivingAustralia/bie-index/issues/134
Associated ALA web service: https://api.ala.org.au/#ws106
http://www.geoapi.org/3.0/javadoc/org/opengis/referencing/doc-files/WKT.html
ala_fields
for occurrence fields that are queryable
via the fq
parameter
if (FALSE) { x <- specieslist(taxon = "genus:Hakea", wkt = "POLYGON((145 -37,150 -37, 150 -30,145 -30,145 -37))") x <- specieslist(wkt = "POLYGON((147.62 -42.83,147.60 -42.86,147.65 -42.87, 147.70 -42.86, 147.62 -42.83))", fq = "rank:species") x <- specieslist(wkt = "POLYGON((145 -37,150 -37,150 -30,145 -30,145 -37))", fq = "genus:Heleioporus") x <- specieslist(wkt = "POLYGON((152.38 -30.43,152.5 -30.43,152.5 -30.5, 152.38 -30.5,152.38 -30.43))", fq = "kingdom:Plantae") ## NOTE that this response might include records with empty or NA kingdom, ## phylum, or class values, as per the note above. }