-
-
Notifications
You must be signed in to change notification settings - Fork 7.7k
Add Dark Sky documentation #992
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
|
||
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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Link should probaly be https://darksky.net/dev/register
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks
|
||
Configuration variables: | ||
|
||
- **api_key** (*Required*): Your API key for http://forecast.io/. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Link to https://darksky.net/
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks
@@ -9,10 +9,14 @@ sharing: true | |||
footer: true | |||
logo: forecast.png | |||
ha_category: Weather |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Category should probably be updated to Deprecated
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Good point. The platform would still work till the EOL of forecast.io but I guess that it would be simpler to get rid of the platform as soon the dependency is available.
Looks good! 🐬 |
I guess that we need to merge in the changes from #990 as those are going to the Forecast page. |
This is the bigger change and should have priority. |
We are waiting for the dependency and Paulus released 0.29 a couple of hours ago. So, it will be in 0.30 (i guess) but not sure if there is enough time to make it available as Weather component ;-) |
First we need a new python-forecastio release. |
With the name change the
forecast
platform will be deprecated and replaced by thedark_sky
sensor platform.