Environment Canada Weather


The environment_canada weather platforms provide meteorological data for Canadian locations from Environment Canada.

The following device types and data are supported:

  • Weather - Current conditions and forecasts
  • Sensor - Current conditions and alerts
  • Camera - Radar imagery

Location Selection

Each platform automatically determines which weather station’s data to use. However, as station coordinates provided by Environment Canada are somewhat imprecise, in some cases you may need to override the automatic selection to use the desired station.

For each platform, the location to use is determined according to the following hierarchy:

  • Location ID specified in platform configuration (optional)
  • Closest station to latitude/longitude specified in platform configuration (optional
  • Closest station to latitude/longitude specified in Home Assistant core configuration

Weather

The environment_canada weather platform populates a weather card with Environment Canada current conditions and forecast data.

To add Environment Canada weather to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
weather:
  - platform: environment_canada
  • The sensor checks for new data every 10 minutes, and the source data is typically updated hourly within 10 minutes after the hour.
  • If no name is given, the weather entity will be named weather.<station_name>.
  • The platform automatically determines which weather station to use based on the system’s latitude/longitude settings. For greater precision, it is also possible to specify either:
    • A specific station code based on this CSV file, or
    • A specific latitude/longitude

Configuration Variables

latitude

(float)(Inclusive)Part of a set of coordinates to use when finding the closest weather station.

longitude

(float)(Inclusive)Part of a set of coordinates to use when finding the closest weather station.

station

(string)(Optional)The station code of a specific weather station to use. Station codes must be in the form `AB/s0000123`, where `AB`is a provincial abbreviation and `s0000123` is a numeric station code. If provided, this station will be used and any latitude/longitude coordinates provided will be ignored.

name

(string)(Optional)Name to be used for the weather entity.

forecast

(string)(Optional)Specify hourly or daily forecasts. Valid values are 'daily' and 'hourly'.

Default value: daily

Sensor

The environment_canada sensor platform creates sensors based on Environment Canada current conditions and alerts.

To add Environment Canada sensors to your installation, add the desired lines from the following example to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: environment_canada
  • By default, a sensor entity is created for each monitored condition and each category of alert. Each sensor entity will be given the device_id of sensor.<optional-name_><condition>.
  • The sensor checks for new data every 10 minutes, and the source data is typically updated hourly within 10 minutes after the hour.
  • The platform automatically determines which weather station to use based on the system’s latitude/longitude settings. For greater precision, it is also possible to specify either:
    • A specific station code based on this CSV file, or
    • A specific latitude/longitude

Configuration Variables

latitude

(float)(Inclusive)Part of a set of coordinates to use when finding the closest weather station.

longitude

(float)(Inclusive)Part of a set of coordinates to use when finding the closest weather station.

station

(string)(Optional)The station code of a specific weather station to use. If provided, this station will be used and any latitude/longitude coordinates provided will be ignored. Station codes must be in the form of `AB/s0000123`, where `AB`is a provincial abbreviation and `s0000123` is a numeric station code.

name

(string)(Optional)Name to be used for the sensor entities.

monitored_conditions

(list)(Required)The conditions to monitor. A sensor will be created for each condition.

Default value: All keys

temperature

The current temperature, in ºC.

dewpoint

The current dewpoint, in ºC.

wind_chill

The current wind chill, in ºC.

humidex

The current humidex, in ºC.

pressure

The current air pressure, in kPa.

tendency

The current air pressure tendency, e.g. "Rising" or "Falling".

humidity

The current humidity, in %.

visibility

The current visibility, in km.

condition

A brief text statement of the current weather conditions, e.g. "Sunny".

wind_speed

The current sustained wind speed, in km/h.

wind_gust

The current wind gust, in km/h.

wind_dir

The current cardinal wind direction, e.g. "SSW".

high_temp

The next forecast high temperature, in ºC.

low_temp

The next forecast low temperature, in ºC.

pop

The next forecast probability of precipitation, in %.

warnings

Current warning alerts.

watches

Current watch alerts.

advisories

Current advisory alerts.

statements

Current special weather statements.

endings

Alerts that have recently ended.

Camera

The environment_canada camera platform displays Environment Canada meteorological radar imagery.

To add Environment Canada radar imagery to your installation, add the desired lines from the following example to your configuration.yaml file:

# Example configuration.yaml entry
camera:
  - platform: environment_canada
  • If no name is given, the camera entity will be named camera.<station_name>_radar.
  • The platform automatically determines which radar station to use based on the system’s latitude/longitude settings. For greater precision, it is also possible to specify either:
    • A specific station ID from this table (remove the leading C, e.g. XFT or ASBV), or
    • A specific latitude/longitude

Configuration Variables

latitude

(float)(Inclusive)Part of a set of coordinates to use when finding the closest radar station.

longitude

(float)(Inclusive)Part of a set of coordinates to use when finding the closest radar station.

station

(string)(Optional)The station code of a specific radar station to use. If provided, this station will be used and any latitude/longitude coordinates provided will be ignored.

name

(string)(Optional)Name to be used for the camera entity.

loop

(boolean)(Optional)Boolean setting to determine whether to display an animated GIF of images from the last 2 hours. If `false`, the latest still image will be displayed.

Default value: true

precip_type

(string)(Optional)Determines whether to use the intensity bands for rain or snow. Valid values are RAIN and SNOW.

Default value: RAIN from April to October, SNOW from November to March