79 lines
2.5 KiB
Markdown
79 lines
2.5 KiB
Markdown
---
|
|
title: "Dark Sky"
|
|
description: "Instructions on how to integrate Dark Sky within Home Assistant."
|
|
featured: false
|
|
logo: dark_sky.png
|
|
ha_category:
|
|
- Weather
|
|
ha_release: 0.61
|
|
ha_iot_class: Cloud Polling
|
|
ha_domain: darksky
|
|
---
|
|
|
|
The `darksky` platform uses the [Dark Sky](https://darksky.net/) web service as a source for meteorological data for your location.
|
|
|
|
## Configuration
|
|
|
|
<div class='note warning'>
|
|
|
|
On March 31, 2020 Dark Sky was [acquired by Apple](https://blog.darksky.net/dark-sky-has-a-new-home/) and is no longer allowing new API registrations. The Dark Sky API will continue to function for existing users [until March 31st, 2023](https://blog.darksky.net/), but it is no longer possible to obtain an API key for new users. Home Assistant supports many alternative [weather integrations](/integrations/#weather).
|
|
|
|
</div>
|
|
|
|
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.
|
|
|
|
<div class='note warning'>
|
|
|
|
[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.
|
|
|
|
</div>
|
|
|
|
To add Dark Sky to your installation, add the following to your `configuration.yaml` file:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
weather:
|
|
- platform: darksky
|
|
api_key: YOUR_API_KEY
|
|
```
|
|
|
|
{% configuration %}
|
|
api_key:
|
|
description: "Your API key for [Dark Sky](https://darksky.net/dev/)."
|
|
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 %}
|
|
|
|
<div class='note'>
|
|
|
|
This platform is an alternative to the [`darksky`](/integrations/darksky) sensor.
|
|
|
|
</div>
|
|
|
|
Details about the API are available in the [Dark Sky documentation](https://darksky.net/dev/docs).
|