Changelog • openaq

openaq v1.0.0 - 2026-03-19

CRAN release: 2026-03-19

Added validate_data_rollup_compat() to validate compatibility between data and rollup parameters in list_sensor_measurements().
Added tests for list_sensor_measurements(), get_period_field(), get_summary_field(), validate_data_rollup_compat(), and transform_vector_to_string().
Added validate_date() and transform_date() to support date-only query parameters when data is "days" or larger. Includes tests for both functions.

Moved maps from Imports to Suggests. World boundary overlay in plot.openaq_locations_data.frame() is now optional. A message is displayed if maps is not installed.
Moved rstudioapi from Imports to Suggests. API key prompting in RStudio is now optional with a fallback error message when running outside RStudio.
Removed purrr and graphics and utils from Imports.
Improved parameter documentation across all resource functions.
Standardized isTRUE() usage for as_data_frame checks across all resource functions.
Updated validate_datetime() to accept a name parameter.
Updated list_sensor_measurements() to use validate_date() or validate_datetime() based on the data argument. Tests updated accordingly.

Fixed missing dry_run early return in list_manufacturer_instruments().
Fixed missing rate_limit and api_key arguments in fetch() calls in list_location_latest() and list_parameter_latest().
Fixed wrong class assignment openaq_licenses_data.frame in as.data.frame.openaq_manufacturers_list().
Fixed tbl$avg <- as.numeric(tbl$sd) typo in as.data.frame.openaq_measurements_list(), column is now correctly assigned to tbl$sd.
Fixed incorrect example function names in as.data.frame methods across all resource files.
Fixed y parameter missing default NULL in plot.openaq_measurements_data.frame() and plot.openaq_measurements_list().

added additional validation to validate_numeric_vectors to prevent out of bounds integers and doubles
added additional validation to restrict radius parameters to fit within max value of 25000 (25km)

parameter_names field in countries resource function as.data.frame fixed to correctly list name values.
parameter_ids field in countries resource function as.data.frame fixed to correctly list ids.
instrument_ids field in manufacturers resource function as.data.frame fixed to correctly list ids.
parameter_ids field in providers resource function as.data.frame fixed to correctly list ids.
documentation fixes

Check data parameter to correctly pass datetime_from and/or datetime_to vs date_to and date_from for list_sensor_measurements.

Updated plot function signature to meet S3 function generic/method consistency requirements
removed support for oldrel-4 version

BREAKING CHANGES
Changed providers_id, parameters_id, owner_contacts_id, manufacturers_id, licenses_id, instruments_id, and countries_id function arguments to be numeric vectors
Changed coordinates function argument to be a named numeric vector with fields latitude and longitude
Changed bbox function argument to be a named numeric vector with fields xmin, ymin, xmax and ymax.

Additional null check for possible null value in summary standard deviation field. Resolved #4

Fix null check in parameters_list.as.data.frame to catch null values in results object.
dry_run check in licenses resource functions

Initial release