KnowAir Historical — Past Weather Data
Query historical weather data for up to 72 hours back using the Caiyun Weather API.
Prerequisites
- A valid Caiyun Weather API token set as
CAIYUN_TOKENenvironment variable, or stored in~/.config/knowair/token. - Coordinates (longitude, latitude) for the target location.
Quick Start
python3 scripts/query_historical.py --lng 116.3176 --lat 39.9760 --hours 24
Workflow
- Resolve coordinates — convert city name to coordinates if needed.
- Run the script:
python3 scripts/query_historical.py --lng <LNG> --lat <LAT> --hours <HOURS> - Present results — summarize temperature range, weather changes, and notable events in the past period.
Options
| Flag | Description | Default |
|---|---|---|
--lng | Longitude (-180 to 180) | Required |
--lat | Latitude (-90 to 90) | Required |
--hours | Hours to look back (1-72) | 24 |
--lang | Output language: en or zh | en |
Defaults
- Hours back: 24
- Language:
en
Failure Handling
- Missing token → exit code 2 with setup instructions.
- API error → exit code 1 with error details.