OpenWeatherMap
The OpenWeatherMap weather integration uses OpenWeatherMap
There is currently support for the following device types within Home Assistant:
- Sensor
- Weather
You need an API key, it requires a subscription
⚠️ 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
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.
-
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 hoursv2.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.
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