aqs_annual_summary_by_box
Retrieve annual air quality statistics for pollutants within a geographic bounding box, including means, percentiles, exceedance counts, and data completeness metrics from EPA monitoring sites.
Instructions
Get annual summary data for all monitoring sites within a geographic bounding box defined by latitude/longitude coordinates. Annual summaries include yearly statistics such as arithmetic mean, standard deviation, maximum values, percentiles (10th through 99th), observation counts, data completeness metrics, and exceedance counts for primary and secondary NAAQS standards.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| No | Email address registered with the AQS API. If not provided, uses AQS_EMAIL environment variable. | ||
| key | No | API key for AQS access. If not provided, uses AQS_API_KEY environment variable. | |
| param | Yes | Parameter code for the pollutant (e.g., "44201" for Ozone, "88101" for PM2.5, "42401" for SO2, "42101" for CO, "42602" for NO2, "81102" for PM10). Up to 5 comma-separated codes allowed. | |
| bdate | Yes | Begin date in YYYYMMDD format. Must be in the same calendar year as edate. | |
| edate | Yes | End date in YYYYMMDD format. Must be in the same calendar year as bdate. | |
| minlat | Yes | Minimum latitude of the bounding box in decimal degrees (e.g., "33.0"). | |
| maxlat | Yes | Maximum latitude of the bounding box in decimal degrees (e.g., "34.5"). | |
| minlon | Yes | Minimum longitude of the bounding box in decimal degrees. Use negative values for western hemisphere (e.g., "-118.5"). | |
| maxlon | Yes | Maximum longitude of the bounding box in decimal degrees. Use negative values for western hemisphere (e.g., "-117.0"). |