rnpn (version 1.3.0)

npn_get_data: Download NPN Data

Description

Generic utility function for querying data from the NPN data services.

Usage

npn_get_data(
  url,
  query,
  download_path = NULL,
  always_append = FALSE,
  six_leaf_raster = NULL,
  six_bloom_raster = NULL,
  agdd_layer = NULL,
  additional_layers = NULL
)

Value

A tibble of the requested data. If a download_path was specified, the file path is returned.

Arguments

url

The URL of the service endpoint to request data from

download_path

String, optional file path to the file for which to output the results.

always_append

Boolean flag. When set to TRUE, then we always append data to the download path. This is used in the case of npn_get_data_by_year() where we're making multiple requests to the same service and aggregating all data results in a single file. Without this flag, otherwise, each call to the service would truncate the output file.

Examples

if (FALSE) {
npn_get_data(
  url = "https://services.usanpn.org/npn_portal//observations/getObservations.ndjson?",
  query = list(
    request_src = "Unit%20Test",
    climate_data = "0",
    `species_id[1]` = "6",
    start_date = "2010-01-01",
    end_date = "2010-12-31"
  )
)
}