2024.11.2
Home ▸ Integrations ▸

OpenWeatherMap

The OpenWeatherMap weather integration 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, it requires a subscription. The subscription has a free tier with 1000 calls/day. Consider setting the limit on the OpenWeatherMap website to stay under the threshold where API usage incurs a cost. This is done in the Billing plans page, under “Calls per day”.

⚠️ Important Deprecation Notice

OpenWeatherMap API V2.5 Deprecation

OpenWeatherMap API V2.5 will be closed on October 7th 2024. After this date, you will need to use API V3.0.

To continue using the service:

  • Visit the OpenWeatherMap website and activate the One Call subscription.
  • During activation, you will be prompted for a credit card, but you will not be charged unless you exceed the free tier limits.
  • Configure your OWM integration to select mode v3.0.
  • Note: Subscription activation may take up to 2 hours.

For more details, set limits on your usage to avoid charges at OpenWeatherMap Subscriptions.

Important

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:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select OpenWeatherMap.

  • Follow the instructions on screen to complete the setup.

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
  • v3.0 (new API version) with daily forecast for 8 days, and 1-hour steps for 48 hours
  • v2.5 (deprecated One Call API version), same forcasts as v3.0
  • current (current weather data only, no forecast)
  • forecast (forecast only, in 3-hour steps for 5 days, no current weather data)
    		•
    Language Language for receiving data (only for sensor)

    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.

    Note

    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 precipitation, mm/h.
    snow Snow precipitation, mm/h.
    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, meter/sec.

    Details about the API are available in the OpenWeatherMap documentation.

    Related topics