jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-05-03 01:28:58 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant.io/source/components/sensor.forecast.markdown
Carlo Costanzo 6cb078395e Additional GPS info for Forecast.io 
Added in information on refining GPS coordinates for FORECAST.IO in configuration.yaml for hyper-local weather events.
2015-09-22 15:46:49 -04:00

2.3 KiB
Raw Blame History

layout, title, description, date, sidebar, comments, sharing, footer
layout title description date sidebar comments sharing footer
page Forecast.io support Instructions how to integrate Forecast.io within Home Assistant. 2015-04-25 9:06 false false true true
The forecast platform uses the [Forecast.io](https://forecast.io/) web service as a source for meteorological data for your location. The location is based on the Longitude and Latitude cooridinates configured in `configuration.yaml`. The cooridinates are auto detected but to take advantage of the hyper-local weather reported by forecast.io, you can refine them down to your exact home address. GPS cooridinates can be found by using Google Maps and clicking on your home.

You need an API key which is free but requires a registration. You can make 1000 requests per day. This means that you could create approximately every 1.4 minute one.

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

# Example configuration.yaml entry
sensor:
  platform: forecast
  api_key: YOUR_APP_KEY
  monitored_conditions:
    - summary
    - precip_type
    - precip_intensity
    - temperature
    - dew_point
    - wind_speed
    - wind_bearing
    - cloud_cover
    - humidity
    - pressure
    - visibility
    - ozone

Configuration variables:

  • api_key (Required): Your API key for http://forecast.io/.
  • display_conditions array (Required): Conditions to display in the frontend.
    • summary: A human-readable text summary.
    • precip_type: The type of precipitation occurring.
    • precip_intensity: The average expected intensity of precipitation occurring.
    • temperature: The current temperature.
    • dew_point: The dew point.
    • wind_speed: The wind speed.
    • wind_bearing: Where the wind is coming from in degrees, with true north at 0° and progressing clockwise.
    • cloud_cover: The percentage of sky occluded by clouds.
    • humidity: The relative humidity.
    • pressure: The sea-level air pressure in millibars.
    • visibility: The average visibility.
    • ozone: The columnar density of total atmospheric ozone in Dobson.

Details about the API are available in the Forecast.io documentation.