mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-15 13:26:54 +00:00
Remove Darksky (#26740)
This commit is contained in:
G Johansson
GitHub
parent
a5b9d2d1da
commit
5c5bc51a98
@ -1,250 +0,0 @@
|
||||
---
|
||||
title: Dark Sky
|
||||
description: How to integrate Dark Sky within Home Assistant.
|
||||
ha_category:
|
||||
- Weather
|
||||
ha_release: '0.30'
|
||||
ha_iot_class: Cloud Polling
|
||||
ha_codeowners:
|
||||
- '@fabaff'
|
||||
ha_domain: darksky
|
||||
ha_platforms:
|
||||
- sensor
|
||||
- weather
|
||||
ha_integration_type: integration
|
||||
---
|
||||
|
||||
The `darksky` platform uses the [Dark Sky](https://darksky.net/) web service as a source for meteorological data for your location. The location is based on the `longitude` and `latitude` coordinates configured in your `configuration.yaml` file. The coordinates are auto-detected but to take advantage of the hyper-local weather reported by Dark Sky, you can refine them down to your exact home address. GPS coordinates can be found by using [Google Maps](https://www.google.com/maps) and clicking on your home or [Openstreetmap](https://www.openstreetmap.org/).
|
||||
|
||||
## Setup
|
||||
|
||||
<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>
|
||||
|
||||
You can make up to 1000 calls per day for free which means that you could make one approximately every 86 seconds.
|
||||
|
||||
<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>
|
||||
|
||||
## Configuration
|
||||
|
||||
To add Dark Sky to your installation, add the following to your `configuration.yaml` file:
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
sensor:
|
||||
- platform: darksky
|
||||
api_key: YOUR_API_KEY
|
||||
forecast:
|
||||
- 0
|
||||
hourly_forecast:
|
||||
- 0
|
||||
- 1
|
||||
monitored_conditions:
|
||||
- summary
|
||||
- icon
|
||||
- temperature
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
api_key:
|
||||
description: Your API key.
|
||||
required: true
|
||||
type: string
|
||||
name:
|
||||
description: Additional name for the sensors.
|
||||
required: false
|
||||
default: Dark Sky
|
||||
type: string
|
||||
forecast:
|
||||
description: List of days in the 7-day forecast you would like to receive data on, starting with today as day 0 and ending with day 7. Any condition from `monitored_conditions` with a daily forecast by Dark Sky will generate a sensor with entity_id `<condition>_<day>d`.
|
||||
required: false
|
||||
type: list
|
||||
hourly_forecast:
|
||||
description: List of hours in the 48-hour forecast you would like to receive data on, starting with this hour as hour 0 and ending with hour 48. Any condition from `monitored_conditions` with an hourly forecast by Dark Sky will generate a sensor with entity_id `<condition>_<hour>h`.
|
||||
required: false
|
||||
type: list
|
||||
language:
|
||||
description: The desired language of the summary properties. The valid options are further down in a table.
|
||||
required: false
|
||||
default: "`en`"
|
||||
type: string
|
||||
latitude:
|
||||
description: Latitude coordinate to monitor weather of (required if **longitude** is specified).
|
||||
required: false
|
||||
default: coordinates from the Home Assistant configuration
|
||||
type: float
|
||||
longitude:
|
||||
description: Longitude coordinate to monitor weather of (required if **latitude** is specified).
|
||||
required: false
|
||||
default: coordinates from the Home Assistant configuration
|
||||
type: float
|
||||
monitored_conditions:
|
||||
description: Conditions to display in the frontend.
|
||||
required: true
|
||||
type: list
|
||||
keys:
|
||||
summary:
|
||||
description: A human-readable text summary.
|
||||
icon:
|
||||
description: A machine-readable text summary, suitable for selecting an icon for display. See [Dark Sky API documentation](https://darksky.net/dev/docs) for the list of possible values.
|
||||
precip_type:
|
||||
description: The type of precipitation occurring at the given time. If `precip_intensity` is zero, then this property will be `unknown`. See [Dark Sky API documentation](https://darksky.net/dev/docs) for the list of possible values.
|
||||
precip_intensity:
|
||||
description: The intensity of precipitation occurring at the given time. This value is conditional on probability (that is, assuming any precipitation occurs at all).
|
||||
precip_probability:
|
||||
description: The probability of precipitation occurring, in percents.
|
||||
precip_accumulation:
|
||||
description: The amount of snowfall accumulation expected to occur. If no snowfall is expected, this property will be `undefined`.
|
||||
temperature:
|
||||
description: The air temperature.
|
||||
apparent_temperature:
|
||||
description: The apparent (or "feels like") temperature.
|
||||
dew_point:
|
||||
description: The dew point.
|
||||
wind_speed:
|
||||
description: The wind speed.
|
||||
wind_gust:
|
||||
description: The wind gust speed.
|
||||
wind_bearing:
|
||||
description: The direction that the wind is coming **from** in degrees, with true north at 0° and progressing clockwise. If `wind_speed` is 0, then this value is `unknown`.
|
||||
cloud_cover:
|
||||
description: The percentage of sky occluded by clouds.
|
||||
humidity:
|
||||
description: The relative humidity.
|
||||
pressure:
|
||||
description: The sea-level air pressure in millibars.
|
||||
visibility:
|
||||
description: The average visibility.
|
||||
ozone:
|
||||
description: The columnar density of total atmospheric ozone at the given time in Dobson units.
|
||||
minutely_summary:
|
||||
description: A human-readable text summary for the next hour.
|
||||
hourly_summary:
|
||||
description: A human-readable text summary for the next two days.
|
||||
daily_summary:
|
||||
description: A human-readable text summary for the next week.
|
||||
temperature_high:
|
||||
description: The daytime high temperature.
|
||||
temperature_low:
|
||||
description: The overnight low temperature.
|
||||
apparent_temperature_high:
|
||||
description: The daytime high apparent temperature.
|
||||
apparent_temperature_low:
|
||||
description: The overnight low apparent temperature.
|
||||
precip_intensity_max:
|
||||
description: The maximum value of `precip_intensity` during a given day.
|
||||
uv_index:
|
||||
description: The UV index.
|
||||
moon_phase:
|
||||
description: "The fractional part of the lunation number during the given day: a value of 0 corresponds to a new moon, 0.25 to a first quarter moon, 0.5 to a full moon, and 0.75 to a last quarter moon."
|
||||
sunrise_time:
|
||||
description: The time of when the sun will rise during a given day.
|
||||
sunset_time:
|
||||
description: The time of when the sun will set during a given day.
|
||||
nearest_storm_distance:
|
||||
description: The approximate distance to the nearest storm in miles.
|
||||
nearest_storm_bearing:
|
||||
description: The approximate direction of the nearest storm in degrees, with true north at 0° and progressing clockwise.
|
||||
alerts:
|
||||
description: Current severe weather advisories.
|
||||
units:
|
||||
description: Specify the unit system. Valid options are `auto`, `us`, `si`, `ca` and `uk2`. `auto` will let Dark Sky decide the unit system based on location.
|
||||
required: false
|
||||
default: "`si` or `us`, based on the temperature preference in Home Assistant."
|
||||
type: string
|
||||
scan_interval:
|
||||
description: "Minimum time interval between updates. Supported formats: `scan_interval: 'HH:MM:SS'`, `scan_interval: 'HH:MM'` and Time period dictionary (see example below)."
|
||||
required: false
|
||||
default: 2 minutes
|
||||
type: time
|
||||
{% endconfiguration %}
|
||||
|
||||
<div class='note'>
|
||||
|
||||
Please note that some monitored conditions, such as `temperature_high` or `temperature_low`, may only work when setting the `forecast` attribute to at least `0` (current day).
|
||||
|
||||
</div>
|
||||
|
||||
#### Time period dictionary example
|
||||
|
||||
```yaml
|
||||
scan_interval:
|
||||
# At least one of these must be specified:
|
||||
days: 0
|
||||
hours: 0
|
||||
minutes: 3
|
||||
seconds: 30
|
||||
milliseconds: 0
|
||||
```
|
||||
|
||||
#### Language options
|
||||
|
||||
All language options are described in this table that you can use for the Dark Sky sensor.
|
||||
|
||||
|Language|Variable Code|
|
||||
|---|---|
|
||||
|Arabic|`ar`|
|
||||
|Azerbaijani|`az`|
|
||||
|Belarusian|`be`|
|
||||
|Bulgarian|`bg`|
|
||||
|Bengali|`bn`|
|
||||
|Bosnian|`bs`|
|
||||
|Catalan|`ca`|
|
||||
|Czech|`cs`|
|
||||
|Danish|`da`|
|
||||
|German|`de`|
|
||||
|Greek|`el`|
|
||||
|English|`en`|
|
||||
|Esperanto|`eo`|
|
||||
|Spanish|`es`|
|
||||
|Estonian|`et`|
|
||||
|Finnish|`fi`|
|
||||
|French|`fr`|
|
||||
|Hebrew|`he`|
|
||||
|Hindi|`hi`|
|
||||
|Croatian|`hr`|
|
||||
|Hungarian|`hu`|
|
||||
|Indonesian|`id`|
|
||||
|Icelandic|`is`|
|
||||
|Italian|`it`|
|
||||
|Japanese|`ja`|
|
||||
|Georgian|`ka`|
|
||||
|Kannada|`kn`|
|
||||
|Korean|`ko`|
|
||||
|Cornish|`kw`|
|
||||
|Latvian|`lv`|
|
||||
|Malayam|`ml`|
|
||||
|Marathi|`mr`|
|
||||
|Norwegian Bokmål|`nb`|
|
||||
|Dutch|`nl`|
|
||||
|Punjabi|`pa`|
|
||||
|Polish|`pl`|
|
||||
|Portuguese|`pt`|
|
||||
|Romanian|`ro`|
|
||||
|Russian|`ru`|
|
||||
|Slovak|`sk`|
|
||||
|Slovenian|`sl`|
|
||||
|Serbian|`sr`|
|
||||
|Swedish|`sv`|
|
||||
|Tamil|`ta`|
|
||||
|Telugu|`te`|
|
||||
|Tetum|`tet`|
|
||||
|Turkish|`tr`|
|
||||
|Ukrainian|`uk`|
|
||||
|Urdu|`ur`|
|
||||
|Igpay Atinlay|`x-pig-latin`|
|
||||
|simplified Chinese|`zh`|
|
||||
|traditional Chinese|`zh-tw`|
|
||||
|
||||
<div class='note warning'>
|
||||
While the platform is called "darksky" the sensors will show up in Home Assistant as "dark_sky" (eg: sensor.dark_sky_summary).
|
||||
</div>
|
||||
|
||||
More details about the API are available in the [Dark Sky API documentation](https://darksky.net/dev/docs).
|
||||
@ -1,78 +0,0 @@
|
||||
---
|
||||
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).
|
||||
@ -434,6 +434,7 @@
|
||||
/integrations/ciscospark /more-info/removed-integration 301
|
||||
/integrations/coinmarketcap /more-info/removed-integration 301
|
||||
/integrations/crimereports /more-info/removed-integration 301
|
||||
/integrations/darksky /more-info/removed-integration 301
|
||||
/integrations/deutsche_bahn /more-info/removed-integration 301
|
||||
/integrations/device_tracker.trackr /more-info/removed-integration 301
|
||||
/integrations/dht /more-info/removed-integration 301
|
||||
@ -519,6 +520,7 @@
|
||||
/integrations/ups /more-info/removed-integration 301
|
||||
/integrations/uscis /more-info/removed-integration 301
|
||||
/integrations/usps /more-info/removed-integration 301
|
||||
/integrations/weather.darksky /more-info/removed-integration 301
|
||||
/integrations/weblink /more-info/removed-integration 301
|
||||
/integrations/wink /more-info/removed-integration 301
|
||||
/integrations/wunderground /more-info/removed-integration 301
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user