Weather
The weather
platforms gather meteorological information from web services and display the conditions and other details about the weather at the given location.
构建模块集成
这个 weather 是一个构建模块集成,无法直接添加到你的 Home Assistant 中,但可以被其他集成使用和提供。
构建模块集成不同于典型的与设备或服务连接的集成。相反,其他将设备或服务集成到 Home Assistant 中的集成使用这个 weather 构建模块来提供实体、服务和其他你可以在自动化或仪表板中使用的功能。
如果你的某个集成具有这个构建模块,这个页面记录了 weather 构建模块所提供的功能。
For a list of weather integrations, on the integrations page, select the weather category.
Read the integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [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 entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more]’s state is used to indicate the current overall conditions, such as ‘cloudy’ or ‘sunny’.
Condition mapping
The weather
entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [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.
lightning
. -
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 entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [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