From d43e3e62f42b1ffa136972b528d3db0cf5117804 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Mon, 26 Sep 2016 18:43:07 +0200 Subject: [PATCH 1/5] Add dark_sky sensor docs --- source/_components/sensor.dark_sky.markdown | 88 +++++++++++++++++++++ 1 file changed, 88 insertions(+) create mode 100644 source/_components/sensor.dark_sky.markdown diff --git a/source/_components/sensor.dark_sky.markdown b/source/_components/sensor.dark_sky.markdown new file mode 100644 index 000000000000..ef4220cff943 --- /dev/null +++ b/source/_components/sensor.dark_sky.markdown @@ -0,0 +1,88 @@ +--- +layout: page +title: "Dark Sky" +description: "How to integrate Dark Sky within Home Assistant." +date: 2016-09-26 08:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: dark_sky.png +ha_category: Weather +featured: true +ha_release: 0.30 +--- + +The `dark_sky` 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](http://www.openstreetmap.org/). + +You need an API key which is free but requires [registration](https://developer.forecast.io/register). You can make up to 1000 calls per day for free which means that you could make one approximately every 86 seconds. + +

+[Dark Sky](https://darksky.net/) 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: + +```yaml +# Example configuration.yaml entry +sensor: + platform: dark_sky + api_key: YOUR_APP_KEY + monitored_conditions: + - summary + - icon + - nearest_storm_distance + - nearest_storm_bearing + - precip_type + - precip_intensity + - precip_probability + - temperature + - apparent_temperature + - dew_point + - wind_speed + - wind_bearing + - cloud_cover + - humidity + - pressure + - visibility + - ozone + - minutely_summary + - hourly_summary + - daily_summary + - temperature_max + - temperature_min + - apparent_temperature_max + - apparent_temperature_min + - precip_intensity_max +``` + +Configuration variables: + +- **api_key** (*Required*): Your API key for http://forecast.io/. +- **monitored_conditions** array (*Required*): Conditions to display in the frontend. + - **summary**: A human-readable text summary of the current conditions. + - **precip_type**: The type of precipitation occurring. + - **precip_intensity**: The average expected intensity of precipitation occurring. + - **precip_probability**: A value between 0 and 1 which is representing the probability of precipitation. + - **temperature**: The current temperature. + - **apparent_temperature**: A numerical value representing the apparent (or "feels like") 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. + - **minutely_summary**: A human-readable text summary for the next hour. + - **hourly_summary**: A human-readable text summary for the next 24 hours. + - **daily_summary**: A human-readable text summary for the next 7 days. + - **temperature_max**: Today's expected high temperature. + - **temperature_min**: Today's expected low temperature. + - **apparent_temperature_max**: Today's expected apparent high temperature. + - **apparent_temperature_min**: Today's expected apparent low temperature. + - **precip_intensity_max**: Today's expected maximum intensity of precipitation. +- **units** (*Optional*): Specify the unit system. Default to `si` or `us` based on the temperature preference in Home Assistant. Other options are `auto`, `us`, `si`, `ca`, and `uk2`. +`auto` will let forecast.io decide the unit system based on location. + +Details about the API are available in the [Dark Sky documentation](https://darksky.net/dev/docs). From 840e26d91ac8085b02cc34d63e74cdcf4c3d856e Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Mon, 26 Sep 2016 18:43:26 +0200 Subject: [PATCH 2/5] Add Dark Sky logo --- source/images/supported_brands/dark_sky.png | Bin 0 -> 8144 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 source/images/supported_brands/dark_sky.png diff --git a/source/images/supported_brands/dark_sky.png b/source/images/supported_brands/dark_sky.png new file mode 100644 index 0000000000000000000000000000000000000000..b9854dff5188b90d2495941f81649eb2425b2780 GIT binary patch literal 8144 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 Date: Mon, 26 Sep 2016 18:43:48 +0200 Subject: [PATCH 3/5] Add deprecation warning --- source/_components/sensor.forecast.markdown | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/source/_components/sensor.forecast.markdown b/source/_components/sensor.forecast.markdown index 5f32c56d364a..6d7081531d7e 100644 --- a/source/_components/sensor.forecast.markdown +++ b/source/_components/sensor.forecast.markdown @@ -9,10 +9,14 @@ sharing: true footer: true logo: forecast.png ha_category: Weather -featured: true +featured: False ha_release: pre 0.7 --- +

+**This platform has been deprecated in favor of the "[dark_sky](/components/sensor.dark_sky/)" platform and will be removed in the future. Please use the "dark_sky" platform.** +

+ The `forecast` platform uses the [Forecast.io](https://forecast.io/) web service as a source of 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 forecast.io, 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](http://www.openstreetmap.org/). You need an API key which is free but requires [registration](https://developer.forecast.io/register). You can make up to 1000 calls per day for free which means that you could make one approximately every 86 seconds. From c5eb39e4e04dde8607c5b07f74fda552641b55d8 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Mon, 26 Sep 2016 22:01:29 +0200 Subject: [PATCH 4/5] Fix links --- source/_components/sensor.dark_sky.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/sensor.dark_sky.markdown b/source/_components/sensor.dark_sky.markdown index ef4220cff943..0f65aab148ce 100644 --- a/source/_components/sensor.dark_sky.markdown +++ b/source/_components/sensor.dark_sky.markdown @@ -15,7 +15,7 @@ ha_release: 0.30 The `dark_sky` 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](http://www.openstreetmap.org/). -You need an API key which is free but requires [registration](https://developer.forecast.io/register). You can make up to 1000 calls per day for free which means that you could make one approximately every 86 seconds. +You need an API key which is free but requires [registration](hhttps://darksky.net/dev/register). You can make up to 1000 calls per day for free which means that you could make one approximately every 86 seconds.

[Dark Sky](https://darksky.net/) will charge you $0.0001 per API call if you enter your credit card details and create more than 1000 calls per day. @@ -58,7 +58,7 @@ sensor: Configuration variables: -- **api_key** (*Required*): Your API key for http://forecast.io/. +- **api_key** (*Required*): Your API key. - **monitored_conditions** array (*Required*): Conditions to display in the frontend. - **summary**: A human-readable text summary of the current conditions. - **precip_type**: The type of precipitation occurring. From fa1d4d51562e2d3be1f4d40df97de8f91767ef1c Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Mon, 26 Sep 2016 22:13:45 +0200 Subject: [PATCH 5/5] Change category --- source/_components/sensor.forecast.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/sensor.forecast.markdown b/source/_components/sensor.forecast.markdown index 6d7081531d7e..ab068f70496f 100644 --- a/source/_components/sensor.forecast.markdown +++ b/source/_components/sensor.forecast.markdown @@ -8,7 +8,7 @@ comments: false sharing: true footer: true logo: forecast.png -ha_category: Weather +ha_category: Deprecated featured: False ha_release: pre 0.7 ---