Skip to content

Add support for the Statistical Weather Data API - #55

Open
dblock wants to merge 2 commits into
masterfrom
add-statistics-api
Open

Add support for the Statistical Weather Data API#55
dblock wants to merge 2 commits into
masterfrom
add-statistics-api

Conversation

@dblock

@dblock dblock commented Aug 27, 2026

Copy link
Copy Markdown
Owner

Description

Adds support for OpenWeather's Statistical Weather Data API, a Pro-tier endpoint that returns statistically calculated (not real historical) weather data based on historical observations for a location.

  • client.statistics_year(lat:, lon:) - stats for all 365 days of the year.
  • client.statistics_month(month, lat:, lon:) - stats for a specific month.
  • client.statistics_day(month, day, lat:, lon:) - stats for a specific day.

Adds OpenWeather::Models::Statistics::Aggregations (top-level response, Enumerable) and Aggregation (per-period result), plus Temp, Wind, Pressure, Humidity, Precipitation, Clouds sub-models. Adds history_endpoint config option, defaulting to https://history.openweathermap.org/data.

This is a paid/Pro-tier API, so specs use hand-crafted VCR cassettes built from OpenWeather's documented example responses (same approach as the existing Hourly/30 Day Forecast Pro specs).

Closes #43.

100% test coverage, 129 examples passing.

Closes #43.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions

github-actions Bot commented Aug 27, 2026

Copy link
Copy Markdown

Danger Report

No issues found.

View run

@dblock

dblock commented Aug 27, 2026

Copy link
Copy Markdown
Owner Author

I don't have a paid OpenWeather subscription, so the VCR cassettes for this Pro-tier API are hand-crafted from the documented example responses rather than recorded against the live API (same approach used for the existing Hourly/30 Day Forecast Pro specs). I won't be merging this myself without someone verifying it against a real paid account.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Statistical Weather Data Support

1 participant