2.5 KiB
title, description, featured, logo, ha_category, ha_release, ha_iot_class, ha_domain
| title | description | featured | logo | ha_category | ha_release | ha_iot_class | ha_domain | |
|---|---|---|---|---|---|---|---|---|
| Dark Sky | Instructions on how to integrate Dark Sky within Home Assistant. | false | dark_sky.png |
|
0.61 | Cloud Polling | darksky |
The darksky platform uses the Dark Sky web service as a source for meteorological data for your location.
Configuration
On March 31, 2020 Dark Sky was acquired by Apple and is no longer allowing new API registrations. The Dark Sky API will continue to function for existing users until March 31st, 2023, but it is no longer possible to obtain an API key for new users. Home Assistant supports many alternative weather integrations.
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 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: float
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: float
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: Dark 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 sensor.
Details about the API are available in the Dark Sky documentation.