The openweathermap weather platform 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.


To add OpenWeatherMap integration go to Configuration >> Integrations and find the integration in the list.

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).
Language Language for receiving data (only for sensor)

The integration creates weather entity and also sensors for all available conditions. Selecting a onecall 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.

For each condition sensor entity will be created with id:

sensor.<integration name>_<monitored condition>

Sensor prints information in language which was selected for integration.

All conditions:

Condition Description
weather A human-readable text summary.
temperature Current temperature.
wind_speed Wind speed.
wind_bearing Wind bearing.
humidity Relative humidity.
pressure Sea-level air pressure in millibars.
clouds Description of cloud coverage.
rain Rain volume.
snow Snow volume.
condition Current weather condition code.
weather_code Current weather code.

Weather entity always will have English language. Home Assistant translate it to user language automatically.

Details about the API are available in the OpenWeatherMap documentation.