Get sites for specified MERMAID project(s). Returns metadata on sites, including site ID and name, notes, latitude and longitude, country, reef type and zone, exposure, and when the site was created and last updated. Optionally get covariates. Requires authorization.

mermaid_get_project_sites(
  project = mermaid_get_default_project(),
  limit = NULL,
  token = mermaid_token(),
  covariates = FALSE
)

Arguments

project

A way to identify the project(s). Can be project IDs (passed as a character vector directly) or projects resulting from mermaid_get_my_projects or mermaid_search_my_projects. Defaults to the projects listed via mermaid_get_default_project, if available.

limit

Number of records to get. Use NULL (the default) to get all records.

token

API token. Authenticate manually via mermaid_auth, or automatically when running any project- or user-specific functions (like this one).

covariates

Whether to include covariates. Defaults to FALSE.

Details

The included covariates are: geomorphic zonation and benthic habitat from the Allen Coral Atlas; market gravity, water pollution (sediments and nitrogen), coastal population, industrial development (number of ports), tourism (reef value), and a cumulative pressure index from A global map of human pressures on tropical coral reefs by Andrello et al., 2022; scores from Risk-sensitive planning for conserving coral reefs under rapid climate change by Beyer et al., 2018.

Examples

if (FALSE) {
projects <- mermaid_get_my_projects()
projects %>%
  mermaid_get_project_sites()
}