OpenWeatherMap


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:

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

Weather

To add OpenWeatherMap to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
weather:
  - platform: openweathermap
    api_key: YOUR_API_KEY

Configuration Variables

api_key

(string)(Required)

Your API key for OpenWeatherMap.

name

(string)(Optional)

Name to use in the frontend.

Default value:

OpenWeatherMap

mode

(string)(Optional)

Can specify hourly, daily of freedaily. Select hourly for a three-hour forecast, daily for daily forecast or freedaily for a five days forecast with the free tier.

Default value:

hourly

latitude

(float)(Optional)

Latitude of the location to display the weather.

Default value:

The latitude in your configuration.yaml file.

longitude

(float)(Optional)

Longitude of the location to display the weather.

Default value:

The longitude in your configuration.yaml file.

This platform is an alternative to the openweathermap sensor.

Sensor

The openweathermap platform uses OpenWeatherMap as a source for current meteorological data for your location. The forecast will show you the condition in 3h.

To add OpenWeatherMap sensor to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: openweathermap
    api_key: YOUR_API_KEY
    monitored_conditions:
      - weather

Configuration Variables

api_key

(string)(Required)

Your API key for OpenWeatherMap.

name

(string)(Optional)

Additional name for the sensors. Default to platform name.

Default value:

OWM

forecast

(string)(Optional)

Enables the forecast. The default is to display the current conditions.

Default value:

false

language

(string)(Optional)

The language in which you want text results to be returned. It’s a two-characters string, e.g., en, es, ru, it, etc.

Default value:

en

monitored_conditions

(list)(Required)

Conditions to display in the frontend.

weather

A human-readable text summary.

temperature

The current temperature.

wind_speed

The wind speed.

wind_bearing

The wind bearing.

humidity

The relative humidity.

pressure

The sea-level air pressure in millibars.

clouds

Description about cloud coverage.

rain

The rain volume.

snow

The snow volume.

weather_code

The current weather condition code.

Details about the API are available in the OpenWeatherMap documentation.