Home ▸ Integrations ▸

Weather

The weather platforms gather meteorological information from web services and display the conditions and other details about the weather at the given location.

Note

Building block integration

This weather is a building block integration that cannot be added to your Home Assistant directly but is used and provided by other integrations.

A building block integration differs from the typical integration that connects to a device or service. Instead, other integrations that do integrate a device or service into Home Assistant use this weather building block to provide entities, services, and other functionality that you can use in your automations or dashboards.

If one of your integrations features this building block, this page documents the functionality the weather building block offers.

For a list of weather integrations, on the integrations page, select the weather category.

Read the integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] documentation for your particular weather provider to learn how to set it up.

Home Assistant currently supports free web services some of which require registration.

State and state attributes

A weather entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more]’s state is used to indicate the current overall conditions, such as ‘cloudy’ or ‘sunny’.

Condition mapping

The weather entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] can provide the conditions listed below as its state:

Clear, night: The sky is clear during the night. clear-night.
Cloudy: There are many clouds in the sky. cloudy.
Fog: There is a thick mist or fog reducing visibility. fog.
Hail: Hailstones are falling. hail.
Lightning: Lightning/thunderstorms are occurring. lighting.
Lightning, rainy: Lightning/thunderstorm is occurring along with rain. lightning-rainy.
Partly cloudy: The sky is partially covered with clouds. partlycloudy.
Pouring: It is raining heavily. pouring.
Rainy: It is raining. rainy.
Snowy: It is snowing. snowy.
Snowy, rainy: It is snowing and raining at the same time. snowy-rainy.
Sunny: The sky is clear and the sun is shining. sunny.
Windy: It is windy. windy.
Windy, cloudy: It is windy and cloudy. windy-variant.
Exceptional: Exceptional weather conditions are occurring. exceptional.

State attributes

Detailed weather conditions as well as the unit of measurements used for the conditions are indicated by state attributes. A weather entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] may not support all the state attributes.

apparent_temperature: 12.0
cloud_coverage: 0
dew_point: 5.0
humidity: 76
precipitation_unit: mm
pressure: 1019
pressure_unit: hPa
temperature: 14.2
temperature_unit: °C
uv_index: 2
visibility: 10
visibility_unit: km
wind_bearing: 260
wind_gust_speed: 51.56
wind_speed: 35.17
wind_speed_unit: km/h

Action weather.get_forecasts

This action populates response data with a mapping of weather services and their associated forecasts.

Data attribute	Optional	Description	Example
`type`	no	The type of forecast, must be one of `daily`, `twice_daily`, or `hourly`. The default is `daily`.	daily

action: weather.get_forecasts
target:
  entity_id:
    - weather.tomorrow_io_home_nowcast
    - weather.toronto_forecast
data:
  type: hourly
response_variable: weather_forecast

The response data field is a mapping of called target entities, each containing the forecast field. forecast is a list of forecasted conditions at a given point in time:

Response data	Description	Example
`datetime`	The time of the forecasted conditions.	2023-02-17T14:00:00+00:00
`is_daytime`	Only set for `twice_daily` forecasts.	False
`apparent_temperature`	The apparent (feels-like) temperature in the unit indicated by the `temperature_unit` state attribute.	10.2
`cloud_coverage`	The cloud coverage in %.	15
`condition`	The weather condition.	Sunny
`dew_point`	The dew point temperature in the unit indicated by the `temperature_unit` state attribute.	6.0
`humidity`	The relative humidity in %.	82
`precipitation_probability`	The probability of precipitation in %.	0
`precipitation`	The precipitation amount in the unit indicated by the `precipitation_unit` state attribute.	0
`pressure`	The air pressure in the unit indicated by the `pressure_unit` state attribute.	1019
`temperature`	The temperature in the unit indicated by the `temperature_unit` state attribute. If `templow` is also provided, this is the higher temperature.	14.2
`templow`	The lower temperature in the unit indicated by the `temperature_unit` state attribute.	5.0
`uv_index`	The UV index.	3
`wind_bearing`	The wind bearing in azimuth angle (degrees) or 1-3 letter cardinal direction.	268
`wind_gust_speed`	The wind gust speed in the unit indicated by the `wind_speed_unit` state attribute.	34.41
`wind_speed`	The wind speed in the unit indicated by the `wind_speed_unit` state attribute.	24.41

Examples

Example template sensor using get_forecasts

Example template sensor that contains the hourly forecast

template:
  - trigger:
      - trigger: time_pattern
        hours: /1
    action:
      - action: weather.get_forecasts
        data:
          type: hourly
        target:
          entity_id: weather.home
        response_variable: hourly
    sensor:
      - name: Temperature forecast next hour
        unique_id: temperature_forecast_next_hour
        state: "{{ hourly['weather.home'].forecast[0].temperature }}"
        unit_of_measurement: °C

Example action response

weather.tomorrow_io_home_nowcast:
  forecast:
    - datetime: "2023-12-07T13:00:00+00:00"
      condition: cloudy
      precipitation_probability: 0
      wind_bearing: 241.19
      temperature: 0.1
      dew_point: -1.9
      wind_speed: 16.88
      precipitation: 0
      humidity: 86
    - datetime: "2023-12-07T14:00:00+00:00"
      condition: cloudy
      precipitation_probability: 0
      wind_bearing: 232.41
      temperature: 0.8
      dew_point: -2.8
      wind_speed: 17.82
      precipitation: 0
      humidity: 77
    - datetime: "2023-12-07T15:00:00+00:00"
      condition: cloudy
      precipitation_probability: 0
      wind_bearing: 236.09
      temperature: 1.1
      dew_point: -2.6
      wind_speed: 17.89
      precipitation: 0
      humidity: 77
weather.toronto_forecast:
  forecast:
    - datetime: "2023-12-07T14:00:00+00:00"
      condition: snowy
      precipitation_probability: 40
      temperature: 0
    - datetime: "2023-12-07T15:00:00+00:00"
      condition: snowy
      precipitation_probability: 40
      temperature: 0
    - datetime: "2023-12-07T16:00:00+00:00"
      condition: snowy
      precipitation_probability: 40
      temperature: 0

Help us improve our documentation

Suggest an edit to this page, or provide/view feedback for this page.

Edit Provide feedback View pending feedback