home-assistant.github.io/source/_components/weather.openweathermap.markdown

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_release	ha_iot_class
page	OpenWeatherMap	Instructions on how to integrate OpenWeatherMap within Home Assistant.	2016-09-29 09:00	true	false	true	true	openweathermap.png	Weather	0.32	Cloud Polling

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

{% linkable_title Configuration %}

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

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 (Required): Your API key for http://openweathermap.org/.
• name (Optional): Name to use in the frontend.
• latitude (Optional): Latitude of the location to display the weather. Defaults to the latitude in your configuration.yaml file.
• longitude (Optional): Longitude of the location to display the weather. Defaults to the longitude in your configuration.yaml file.

This platform is an alternative to the [`openweathermap`](/components/sensor.openweathermap/) sensor.