home-assistant.io/source/_components/sensor.openweathermap.markdown

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release, ha_iot_class

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_release	ha_iot_class
page	OpenWeatherMap Sensor	Instructions how to integrate OpenWeatherMap within Home Assistant.	2015-04-25 9:06	true	false	true	true	openweathermap.png	Weather	pre 0.7	Cloud Polling

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

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
sensor:
  - platform: openweathermap
    api_key: YOUR_API_KEY
    monitored_conditions:
      - weather

Configuration variables:

• api_key (Required): Your API key for http://openweathermap.org/.
• name (Optional): Additional name for the sensors. Default to platform name.
• forecast (Optional): Enables the forecast. The default is to display the current conditions.
• language (Optional): The language in which you want text results to be returned. It's a two-characters string, eg. en, es, ru, it, etc. Defaults to English.
• monitored_conditions array (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

Details about the API are available in the OpenWeatherMap documentation.