NEWS

flowcam 0.1.0.9000

set_usgs_api_key() replaces set_nims_key(), which is now deprecated.
New get_site_streamflow() retrieves instantaneous or daily discharge (or any USGS parameter) for a gage site, making it easy to pair visual camera conditions with measured flow data.
find_gage_cameras() now correctly returns drainage_area and altitude columns (the previous names drain_area_va and alt_va were stale legacy column names that caused these fields to silently drop).

New get_site_data_availability() returns the full list of parameter codes and periods of record available at a gage — a useful first step before calling get_site_streamflow().
New get_flow_statistics() retrieves historical day-of-year percentile curves (type = "daily_normals") or annual/monthly period-of-record summaries (type = "period_summary"), providing context for interpreting what a camera is showing relative to historical norms.
New get_site_field_measurements() retrieves manual discharge measurements made by USGS hydrographers, which can be compared directly against camera imagery taken at the same time.
New get_network_cameras() uses the USGS Network Linked Data Index (NLDI) to find cameras on the same stream network, upstream and/or downstream of a given site.
get_site_streamflow() now accepts multiple parameter_code values in a single call; all requested parameters are returned in one tibble.
get_site_streamflow() gains a water_year argument: when TRUE, a water_year integer column (Oct 1 – Sep 30) is appended to the result.
find_gage_cameras() gains an include_availability argument (default TRUE) that appends a data_types list-column with available time series from get_site_data_availability().

build_image_url() now errors immediately when camera_row has more than one row, rather than silently using the first row.
find_cameras() now warns when a lat or lng value cannot be coerced to numeric, instead of producing a silent NA.
get_flow_statistics() now warns when percentile or sample_count values cannot be coerced to integer, instead of silently producing NA.
get_site_field_measurements(), get_site_streamflow(), and get_flow_statistics() now validate that parameter_code values are five-digit character strings (e.g. "00060"), matching the existing validation in get_site_streamflow().
get_site_data_availability() and get_site_field_measurements() now share the same parameter_code validation as the other dataRetrieval functions.
get_timelapse_url() now returns NULL invisibly (instead of an unusable URL) when timelapse is not enabled for a camera, while still issuing a warning.
make_gif() / make_video() now warn when local image files have unparseable timestamps and will be excluded from time filtering.

Query USGS NIMS API camera metadata with find_cameras() and find_gage_cameras().
List available images for a camera with list_images().
Build and retrieve timelapse image URLs with build_image_url() and get_timelapse_url().
Download images to disk with download_images().
Assemble animated GIFs from downloaded frames with make_gif().
Assemble MP4 videos from downloaded frames with make_video() (requires the av package).
API key management via set_usgs_api_key() and the API_USGS_PAT environment variable.