Home Assistant Home Assistant

OpenWeatherMap

The OpenWeatherMap weather integrations uses OpenWeatherMap as a source for current meteorological data for your location.

There is currently support for the following device types within Home Assistant:

  • Sensor
  • Weather

You need an API key, which is free, but requires a registration.

If you register an new API key with OpenWeatherMap, it will be activated automatically, this typically takes between 10 minutes and 2 hours after your successful registration. Keep in mind when configuring this integration, that you new API key might not be activated yet. Recent policy changes limit the API access for new registered users with a free plan, they should select the `hourly` mode. The other modes require a paid subscription plan. Invalid API-key errors might occur if your API key is used with the other modes.

Configuration

To add the OpenWeatherMap integration to your Home Assistant instance, use this My button:

Parameter Value
API Key API Key from the website
Name Name of the integration
Latitude Latitude for weather forecast and sensor
Longitude Longitude for weather forecast and sensor
Mode Forecast mode, hourly for a three-hour forecast, daily for daily forecast using a paid API tier, onecall_hourly for an hourly forecast up to 2 days, or onecall_daily for a daily forecast up to 7 days (ideal for the free tier, default).
Language Language for receiving data (only for sensor)

The integration creates a weather entity as well as sensors for supported weather conditions. Selecting a onecall forecast mode with the free tier leverages the One Call API, resulting in updates every 5 minutes and is recommended for both hourly and daily forecast.

A sensor entity will be created for each supported condition. Their ids will follow the format:

sensor.<integration name>_<monitored condition>

Sensors provide data in the language that was selected when configuring the integration.

The Weather entity provides data only in English. Home Assistant automatically translates it to the language configured for the frontend.

Supported Weather Conditions

Current Weather Conditions

Condition Description
cloud_coverage Cloudiness, %.
condition Weather condition.
dew_point Atmospheric temperature below which water droplets begin to condense and dew can form, ºC.
feels_like_temperature Temperature accounting for the human perception of weather, ºC.
humidity Humidity, %.
precipitation_kind The kind of precipitation (Rain, Snow, Snow and Rain, None) for the last hour.
pressure Atmospheric pressure at sea level, hPa.
rain Rain volume for the last hour, mm.
snow Snow volume for the last hour, mm.
temperature Temperature, ºC.
uv_index UV Index.
visibility Average visibility, m.
weather A human-readable description of the weather condition.
weather_code ID of the weather condition.
wind_bearing Wind direction, degrees (meteorological).
wind_speed Wind speed, metre/sec.

Forecast Weather Conditions

The time period these sensors use depends on the forecast mode selected when configuring the integration: hourly or onecall_hourly will show conditions for the current hour of the day, while daily or onecall_daily will show conditions for the current day.

Condition Description
forecast_cloud_coverage Cloudiness, %.
forecast_condition Weather condition for the forecast’s time period.
forecast_precipitation Combined Rain and Snow volume for the forecast’s time period, mm.
forecast_precipitation_probability Probability of precipitation for the forecast’s time period.
forecast_pressure Atmospheric pressure at sea level for the forecast’s time period, hPa.
forecast_temperature Maximum temperature for the day.
forecast_temperature_low Minimum temperature for the day.
forecast_time Time of the forecasted data.
forecast_wind_bearing Wind direction for the forecast’s time period, degrees (meteorological).
forecast_wind_speed Wind speed for the forecast’s time period, metre/sec.

Details about the API are available in the OpenWeatherMap documentation.