From 89d868d909be7d883900ffc17bb87c0596378fbe Mon Sep 17 00:00:00 2001 From: MinchinWeb Date: Mon, 28 Mar 2016 12:59:18 -0600 Subject: [PATCH] Update Sun documentation (`elevation` parameter) `elevation` parameter provides physical elevation. Solar elevation changes throughout the day and is provided by the `Sun` entity, not a parameter to it. Clarify parameters: that times given are in UTC (not local time), and the `elevation` provided here is different from the `elevation` parameter above. Also update provided elevation to that at provided location. --- source/_components/sun.markdown | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/source/_components/sun.markdown b/source/_components/sun.markdown index 18058bc1421..e5538d3a9e7 100644 --- a/source/_components/sun.markdown +++ b/source/_components/sun.markdown @@ -22,12 +22,12 @@ homeassistant: longitude: -117.22743 sun: - elevation: 123 + elevation: 102 ``` Configuration variables: -- **elevation** (*Optional*): The solar elevation angle is the altitude of the sun. If ommitted will be retrieved from Google Maps. +- **elevation** (*Optional*): The (physical) elevation of your location, in metres above sea level. If ommitted will be retrieved from Google Maps.

@@ -59,5 +59,6 @@ The sun event need to have the type 'sun', which service to call, which event (s | State Attributes | Description | | --------- | ----------- | -| `next_rising` | Date and time of the next sun rising -| `next_setting` | Date and time of the next sun setting +| `next_rising` | Date and time of the next sun rising (in UTC). +| `next_setting` | Date and time of the next sun setting (in UTC). +| `elevation` | Solar elevation. This is the angle between the sun and the horizon. Negative values mean the sun is below the horizon.