When conducting a search or creating a data query, it is common to identify a known taxon or group of taxa to narrow down the records or results returned.
Arguments
- ...
one or more scientific names (if
search = TRUE) or taxonomic identifiers (ifsearch = FALSE); or an object of classala_id(fromsearch_taxa).- search
(logical); should the results in question be passed to
search_taxa?
Details
galah_identify() is used to identify taxa you want returned in a search or
a data query. Users to pass scientific names or taxonomic identifiers
with pipes to provide data only for the biological group of interest.
It is good to use search_taxa() and search_identifiers()
first to check that the taxa you provide to galah_identify() return the
correct results.
See also
search_taxa() to find identifiers from scientific names;
search_identifiers() for how to get names if taxonomic identifiers
are already known.
Examples
# Specify a taxon. A valid taxon will return an identifier.
galah_identify("reptilia")
#> # A tibble: 1 × 1
#> identifier
#> <chr>
#> 1 https://biodiversity.org.au/afd/taxa/682e1228-5b3c-45ff-833b-550efd40c399
# Specify more than one taxon at a time.
galah_identify("reptilia", "mammalia", "aves", "pisces")
#> # A tibble: 4 × 1
#> identifier
#> <chr>
#> 1 https://biodiversity.org.au/afd/taxa/682e1228-5b3c-45ff-833b-550efd40c399
#> 2 https://biodiversity.org.au/afd/taxa/e9e7db31-04df-41fb-bd8d-e0b0f3c332d6
#> 3 https://biodiversity.org.au/afd/taxa/65625205-db74-4a87-b566-ca387b119974
#> 4 https://biodiversity.org.au/afd/taxa/e22efeb4-2cb5-4250-8d71-61c48bdaa051
# Use `galah_identify()` to narrow your queries
galah_call() |>
galah_identify("Eolophus") |>
atlas_counts()
#> # A tibble: 1 × 1
#> count
#> <int>
#> 1 957876
# If you know a valid taxon identifier, add it and set `search = FALSE`.
galah_call() |>
galah_identify("https://biodiversity.org.au/afd/taxa/009169a9-a916-40ee-866c-669ae0a21c5c",
search = FALSE) |>
atlas_counts()
#> # A tibble: 1 × 1
#> count
#> <int>
#> 1 957876