home-assistant.io/source/_components/openweathermap.markdown
2019-04-03 10:16:08 -07:00

1.8 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release, ha_iot_class, redirect_from
layout title description date sidebar comments sharing footer logo ha_category ha_release ha_iot_class redirect_from
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
/components/weather.openweathermap/

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 %} api_key: description: Your API key for OpenWeatherMap. required: true type: string name: description: Name to use in the frontend. required: false type: string default: OpenWeatherMap mode: description: "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." required: false type: string default: "hourly" latitude: description: Latitude of the location to display the weather. required: false type: float default: "The latitude in your configuration.yaml file." longitude: description: Longitude of the location to display the weather. required: false type: float default: "The longitude in your configuration.yaml file." {% endconfiguration %}

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