home-assistant.io/source/_components/weather.darksky.markdown
Franck Nijhof ebca3218c7
🔥Removes linkable_title everywhere (#9772)
* Automatically create linkable headers

* Visually improve position of linkable header chain icon

* Do not auto link  headers on homepage

* Remove linkable_title everywhere

* 🚑 Re-instante linkable_title plugin as NOOP
2019-07-04 19:08:27 +02:00

2.2 KiB

layout, title, description, date, sidebar, comments, sharing, footer, featured, logo, ha_category, ha_release, ha_iot_class
layout title description date sidebar comments sharing footer featured logo ha_category ha_release ha_iot_class
page Dark Sky Instructions on how to integrate Dark Sky within Home Assistant. 2016-09-29 09:00 true false true true true dark_sky.png
Weather
0.61 Cloud Polling

The darksky platform uses the Dark Sky web service as a source for meteorological data for your location.

Configuration

You need an API key which is free but requires registration. The free tier allows up to 1000 calls per day, this platform updates at most every 3 minutes, using up to 480 of those calls.

[Dark Sky](https://darksky.net/dev/) will charge you $0.0001 per API call if you enter your credit card details and create more than 1000 calls per day.

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

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

{% configuration %} api_key: description: "Your API key for Dark Sky." required: true type: string latitude: description: Manually specify latitude. By default the value will be taken from the Home Assistant configuration. required: false type: number default: Provided by Home Assistant configuration longitude: description: Manually specify longitude. By default the value will be taken from the Home Assistant configuration. required: false type: number default: Provided by Home Assistant configuration units: description: "Manually specify unit system. Valid values are: auto, us, si, ca, uk and uk2." required: false type: string default: "si if Home Assistant unit system is metric, us if imperial." name: description: Name to use in the frontend. required: false type: string default: Open Sky mode: description: "The forecast type. Can be hourly or daily." required: false type: string default: hourly {% endconfiguration %}

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

Details about the API are available in the Dark Sky documentation.