List available aerial surveys

Returns a lightweight summary of available aerial surveys, useful for discovering which survey combinations (species, analysis unit, survey type, bio year) exist. Much faster than sight_read_entries() when you only need to know what surveys are available rather than individual observations.

Usage

sight_read_surveys(
  species = NULL,
  survey_type = NULL,
  analysis_unit = NULL,
  bio_year = NULL,
  compact = TRUE,
  pages = list(omit = 1),
  dry_run = FALSE,
  ...
)

sight_read_surveys_id(
  species_id = NULL,
  survey_type_id = NULL,
  analysis_unit_id = NULL,
  bio_year = NULL,
  compact = TRUE,
  pages = list(omit = 1),
  dry_run = FALSE,
  ...
)

Arguments

species

the common name of the species, for example "Mule Deer"

survey_type

the name of the survey type, for example "Sightability"

analysis_unit

the name of the analysis unit

bio_year

the biological year the survey was conducted in

compact

if TRUE (the default), returns a compact summary with one row per survey. If FALSE, returns a more detailed summary.

pages

a named list with pagination options, see sight_read_entries() for details

dry_run

If TRUE, print the HTTP request without sending it and return the request object invisibly. Useful for debugging.

...

Additional arguments passed to the underlying spdgt.auth function (e.g., verbosity, timeout).

species_id

the ID of the species

survey_type_id

the ID of the survey type

analysis_unit_id

the ID of the analysis unit (DAU)

Value

A tibble with one row per survey summary

See also

sight_read_entries() for full observation-level data

Examples

if (FALSE) { # \dontrun{
# Discover available surveys for Mule Deer
sight_read_surveys(species = "Mule Deer")

sight_read_surveys(species = "Mule Deer", compact = FALSE)

# Find available years for a specific DAU and survey type
sight_read_surveys(
  species = "Mule Deer",
  survey_type = "Sightability-Abundance",
  analysis_unit = "DAU 350"
)
} # }