---
id: env-canada
version: "0.19.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# env_canada — A package to access meteorological data from Environment Canada

License: permissive · Maintenance: active · Downloads: 95.2K/mo

## What it is and what it does

env_canada is an async Python client for Environment Canada's public meteorological and environmental data services. It wraps multiple data sources—weather stations, radar, alerts, air quality indices, and hydrometric measurements—into a unified interface, automatically discovering station locations from coordinates or accepting explicit station codes in flexible formats.

The package is built on aiohttp for async I/O and uses geopy for coordinate handling, lxml for parsing, and pandas for data manipulation. It handles Environment Canada's dynamic infrastructure (including timestamped URL structures as of June 2025) transparently. Typical usage involves instantiating a data class (ECWeather, ECAlerts, ECRadar, etc.), calling update() asynchronously, and accessing the resulting properties. It supports bilingual output and customizable map rendering.

Use it for:

- Fetch current weather conditions and forecasts for a location by coordinates or station code for a weather app or dashboard.
- Retrieve active weather alerts (warnings, watches, advisories) with full text and risk levels for alert aggregation or notification systems.
- Generate animated radar loops or static weather map images with customizable layers, opacity, and dimensions for web display.
- Monitor air quality health index (AQHI) and hydrometric data (water level/flow) for environmental or public health applications.
- Build historical weather analysis by querying daily or hourly data for a station across specific years and date ranges.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides async access to Environment Canada weather observations, forecasts, alerts, radar imagery, maps, air quality, and hydrometric data via public APIs.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive MIT license. It provides a well-structured async interface to Environment Canada data that would otherwise require direct API calls. Install if you need Canadian weather, alerts, or environmental data in a Python application.

## Install

pip install env-canada
uv add env-canada
poetry add env-canada

## Installing env_canada

Before you install: Low install friction with a pure-Python wheel. Actively maintained as of 2026-08-09 with recent releases. Requires Python 3.11 or later.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions—suitable for most projects.

Quickstart:

import asyncio
from env_canada import ECWeather

ec = ECWeather(coordinates=(50, -100))
await ec.update()  # or asyncio.run(ec.update()) outside Jupyter
print(ec.conditions)
print(ec.daily_forecasts)

Requires Python 3.11 or later. In Jupyter notebooks, use `await` instead of `asyncio.run()`.

Verify before relying:

- Whether the package handles rate limiting or throttling for Environment Canada API endpoints
- Reliability and uptime guarantees for the underlying Environment Canada data sources
- Whether historical data retrieval has date range limits or data availability constraints

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 95.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

environment canada weather data, canadian weather api python, environment canada alerts, weather radar canada, air quality canada aqhi, hydrometric data canada, canadian weather forecasts, weather-data, canadian-apis, async-io

[View on SkillFed](https://skillfed.io/packages/env-canada) · [View on PyPI](https://pypi.org/project/env-canada/)