Weather Entity

Derive entity platforms from homeassistant.components.weather.WeatherEntity

Properties

tip

Properties should always only return information from memory and not do I/O (like network requests). Implement update() or async_update() to fetch data.

Name	Type	Default	Description
condition	string	Required	The current weather condition.
native_temperature	float	Required	The current temperature in °C or °F.
native_temperature_unit	string	Required	The temperature unit; °C or °F.
native_pressure	float	None	The current air pressure in hPa, mbar, inHg or mmHg.
native_pressure_unit	string	None	The air pressure unit; hPa, mbar, inHg or mmHg. Required if native_pressure is set.
humidity	float	None	The current humidity in %.
ozone	float	None	The current ozone level.
native_visibility	float	None	The current visibility in km or mi.
native_visibility_unit	string	None	The visibility unit; km or mi. Required if native_visibility is set.
native_wind_speed	float	None	The current wind speed in m/s, km/h or mi/h.
native_wind_speed_unit	string	None	The wind speed unit; m/s, km/h or mi/h. Required if native_wind_speed is set.
native_precipitation_unit	string	None	The precipitation unit; mm or in.
wind_bearing	float or string	None	The current wind bearing in azimuth angle (degrees) or 1-3 letter cardinal direction.
forecast	array	None	Daily or Hourly forecast data.

Unit Conversion

Properties have to follow the units mentioned on the respective unit of measurement in the table.

To the user, properties will be presented according to the unit system. This is achieved by automatically converting units when creating state objects.

For each weather entity, the user also has the option to override the presentation units, i.e., the units used in the state objects.

Forecast

Forecast data should either be daily or hourly.

Name	Type	Default	Description
datetime	string	Required	UTC Date time in RFC 3339 format.
native_temperature	float	Required	The higher temperature in °C or °F
condition	string	None	The weather condition at this point.
native_templow	float	None	The lower daily Temperature in °C or °F
native_precipitation	float	None	The precipitation amount in mm or in.
precipitation_probability	int	None	The probability of precipitation in %.
native_pressure	float	None	The air pressure in hPa, mbar, inHg or mmHg.
wind_bearing	float or string	None	The wind bearing in azimuth angle (degrees) or 1-3 letter cardinal direction.
native_wind_speed	int	None	The wind speed in m/s, km/h or mi/h.

Forecast data needs to follow the same unit of measurement as defined for properties where applicable.

Recommended values for state and condition

These weather conditions are included in our translation files and also show the corresponding icon.

Condition	Description
clear-night	Clear night
cloudy	Many clouds
exceptional	Exceptional
fog	Fog
hail	Hail
lightning	Lightning/ thunderstorms
lightning-rainy	Lightning/ thunderstorms and rain
partlycloudy	A few clouds
pouring	Pouring rain
rainy	Rain
snowy	Snow
snowy-rainy	Snow and Rain
sunny	Sunshine
windy	Wind
windy-variant	Wind and clouds

This means that the weather platforms don't need to support languages.