mirror of
https://github.com/openhab/openhab-addons.git
synced 2025-01-11 15:42:10 +01:00
369 lines
31 KiB
Markdown
369 lines
31 KiB
Markdown
# Dark Sky Binding
|
|
|
|
This binding integrates the [Dark Sky API](https://darksky.net/dev/docs).
|
|
|
|
::: tip Note
|
|
The Dark Sky API service for existing customers will continue until the end of 2022.
|
|
They do no longer accept new signups.
|
|
:::
|
|
|
|
## Supported Things
|
|
|
|
There are two supported things.
|
|
|
|
### Dark Sky Account
|
|
|
|
First one is a bridge `weather-api` which represents the Dark Sky account.
|
|
The bridge holds the mandatory API key to access the Dark Sky API and several global configuration parameters.
|
|
If your system language is supported by the Dark Sky API it will be used as default language for the requested data.
|
|
|
|
### Current Weather And Forecast
|
|
|
|
The second thing `weather-and-forecast` supports the [current weather](https://darksky.net/dev/docs#forecast-request), hour-by-hour forecast for the next 48 hours and day-by-day forecast for the next week for a specific location.
|
|
It requires coordinates of the location of your interest.
|
|
You can add as many `weather-and-forecast` things for different locations to your setup as you like to observe.
|
|
Severe [weather alerts](https://darksky.net/dev/docs/sources) are available in the USA, Canada, Iceland, European Union member nations, and Israel.
|
|
|
|
## Discovery
|
|
|
|
If a system location is set, a "Local Weather And Forecast" (`weather-and-forecast`) thing will be automatically discovered for this location.
|
|
Once the system location will be changed, the background discovery updates the configuration of "Local Weather And Forecast" accordingly.
|
|
|
|
## Thing Configuration
|
|
|
|
### Dark Sky Account
|
|
|
|
| Parameter | Description |
|
|
|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
| apikey | API key to access the Dark Sky API. **Mandatory** |
|
|
| refreshInterval | Specifies the refresh interval (in minutes). Optional, the default value is 60, the minimum value is 1. Note: when using a free API key (1000 calls/day), do not use an interval less than 2. |
|
|
| language | Language to be used by the Dark Sky API. Optional, valid values are: `ar`, `az`, `be`, `bg`, `bn`, `bs`, `ca`, `cs`, `da`, `de`, `el`, `en`, `eo`, `es`, `et`, `fi`, `fr`, `he`, `hi`, `hr`, `hu`, `id`, `is`, `it`, `ja`, `ka`, `ko`, `kn`, `kw`, `lv`, `mr`, `nb`, `nl`, `no`, `pa`, `pl`, `pt`, `ro`, `ru`, `sk`, `sl`, `sr`, `sv`, `ta`, `te`, `tet`, `tr`, `uk`, `x-pig-latin`, `zh`, `zh-tw`. |
|
|
|
|
### Current Weather And Forecast
|
|
|
|
| Parameter | Description |
|
|
|----------------|-------------------------------------------------------------------------------------------------------------------------------|
|
|
| location | Location of weather in geographical coordinates (latitude/longitude/altitude). **Mandatory** |
|
|
| forecastHours | Number of hours for hourly forecast. Optional, the default value is 24 (min="0", max="48", step="1"). |
|
|
| forecastDays | Number of days for daily forecast (including todays forecast). Optional, the default value is 8 (min="0", max="8", step="1"). |
|
|
| numberOfAlerts | Number of alerts to be shown. Optional, the default value is 0 (min="0", step="1"). |
|
|
|
|
Once one of the parameters `forecastHours`, `forecastDays` or `numberOfAlerts` will be changed, the available channel groups on the thing will be created or removed accordingly.
|
|
|
|
## Channels
|
|
|
|
### Current Weather
|
|
|
|
| Channel Group ID | Channel ID | Item Type | Description |
|
|
|------------------|----------------------|----------------------|-------------------------------------------------------------------------|
|
|
| current | time-stamp | DateTime | Time of data observation. |
|
|
| current | condition | String | Current weather condition. |
|
|
| current | icon | Image | Icon representing the current weather condition. |
|
|
| current | icon-id | String | Id of the icon representing the current weather condition. **Advanced** |
|
|
| current | temperature | Number:Temperature | Current temperature. |
|
|
| current | apparent-temperature | Number:Temperature | Current apparent temperature. |
|
|
| current | pressure | Number:Pressure | Current barometric pressure. |
|
|
| current | humidity | Number:Dimensionless | Current atmospheric humidity. |
|
|
| current | wind-speed | Number:Speed | Current wind speed. |
|
|
| current | wind-direction | Number:Angle | Current wind direction. |
|
|
| current | gust-speed | Number:Speed | Current gust speed. **Advanced** |
|
|
| current | cloudiness | Number:Dimensionless | Current cloudiness. |
|
|
| current | visibility | Number:Length | Current visibility. |
|
|
| current | rain | Number:Speed | Current rain intensity. |
|
|
| current | snow | Number:Speed | Current snow intensity. |
|
|
| current | precip-intensity | Number:Speed | Current precipitation intensity. |
|
|
| current | precip-probability | Number:Dimensionless | Current precipitation probability. |
|
|
| current | precip-type | String | Current precipitation type (Rain, Snow or Sleet). |
|
|
| current | uvindex | Number | Current UV index. |
|
|
| current | ozone | Number:ArealDensity | Current ozone. |
|
|
|
|
### Hourly Forecast
|
|
|
|
| Channel Group ID | Channel ID | Item Type | Description |
|
|
|-------------------------------------------------------|----------------------|----------------------|------------------------------------------------------|
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | time-stamp | DateTime | Time of data forecasted. |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | condition | String | Forecast weather condition. |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | icon | Image | Icon representing the forecasted weather condition. |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | icon-id | String | Id of the forecasted weather condition. **Advanced** |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | temperature | Number:Temperature | Forecasted temperature. |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | apparent-temperature | Number:Temperature | Forecasted apparent temperature. |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | pressure | Number:Pressure | Forecasted barometric pressure. |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | humidity | Number:Dimensionless | Forecasted atmospheric humidity. |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | wind-speed | Number:Speed | Forecasted wind speed. |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | wind-direction | Number:Angle | Forecasted wind direction. |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | gust-speed | Number:Speed | Forecasted gust speed. **Advanced** |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | cloudiness | Number:Dimensionless | Forecasted cloudiness. |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | visibility | Number:Length | Forecasted visibility. |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | rain | Number:Speed | Forecasted rain intensity. |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | snow | Number:Speed | Forecasted snow intensity. |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | precip-intensity | Number:Speed | Forecasted precipitation intensity. |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | precip-probability | Number:Dimensionless | Forecasted precipitation probability. |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | precip-type | String | Forecasted precipitation type (Rain, Snow or Sleet). |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | uvindex | Number | Forecasted UV index. |
|
|
| forecastHours01, forecastHours02, ... forecastHours48 | ozone | Number:ArealDensity | Forecasted ozone. |
|
|
|
|
### Daily Forecast
|
|
|
|
| Channel Group ID | Channel ID | Item Type | Description |
|
|
|-----------------------------------------------------------------|--------------------------|----------------------|------------------------------------------------------|
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | time-stamp | DateTime | Time of data forecasted. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | condition | String | Forecast weather condition. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | icon | Image | Icon representing the forecasted weather condition. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | icon-id | String | Id of the forecasted weather condition. **Advanced** |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | min-temperature | Number:Temperature | Minimum forecasted temperature of a day. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | max-temperature | Number:Temperature | Maximum forecasted temperature of a day. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | min-apparent-temperature | Number:Temperature | Minimum forecasted apparent temperature of a day. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | max-apparent-temperature | Number:Temperature | Maximum forecasted apparent temperature of a day. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | pressure | Number:Pressure | Forecasted barometric pressure. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | humidity | Number:Dimensionless | Forecasted atmospheric humidity. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | wind-speed | Number:Speed | Forecasted wind speed. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | wind-direction | Number:Angle | Forecasted wind direction. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | gust-speed | Number:Speed | Forecasted gust speed. **Advanced** |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | cloudiness | Number:Dimensionless | Forecasted cloudiness. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | visibility | Number:Length | Forecasted visibility. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | rain | Number:Speed | Forecasted rain intensity. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | snow | Number:Speed | Forecasted snow intensity. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | precip-intensity | Number:Speed | Forecasted precipitation intensity. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | precip-probability | Number:Dimensionless | Forecasted precipitation probability. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | precip-type | String | Forecasted precipitation type (Rain, Snow or Sleet). |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | uvindex | Number | Forecasted UV index. |
|
|
| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | ozone | Number:ArealDensity | Forecasted ozone. |
|
|
|
|
### Severe Weather Alerts
|
|
|
|
| Channel Group ID | Channel ID | Item Type | Description |
|
|
|-----------------------|-------------|-----------|----------------------------------------------------------------------------------------------|
|
|
| alerts1, alerts2, ... | title | String | A brief description of the alert. |
|
|
| alerts1, alerts2, ... | description | String | A detailed description of the alert. |
|
|
| alerts1, alerts2, ... | severity | String | The severity of the alert. |
|
|
| alerts1, alerts2, ... | issued | DateTime | The time at which the alert was issued. |
|
|
| alerts1, alerts2, ... | expires | DateTime | The time at which the alert will expire. |
|
|
| alerts1, alerts2, ... | uri | String | An external URI that one may refer to for detailed information about the alert. **Advanced** |
|
|
|
|
## Trigger Channels
|
|
|
|
### Current Weather
|
|
|
|
| Channel Group ID | Channel ID | Description |
|
|
|------------------|---------------|-----------------------------------------|
|
|
| current | sunrise-event | Event for sunrise. Can trigger `START`. |
|
|
| current | sunset-event | Event for sunset. Can trigger `START`. |
|
|
|
|
### Configuration
|
|
|
|
**Offset:** For each trigger channel you can optionally configure an `offset` in minutes.
|
|
The `offset` must be configured in the channel properties for the corresponding thing.
|
|
The minimum allowed `offset` is -1440 and the maximum allowed `offset` is 1440.
|
|
|
|
If an `offset` is set, the event is moved forward or backward accordingly.
|
|
|
|
**Earliest / Latest:** For each trigger channel you can optionally configure the `earliest` and `latest` time of the day.
|
|
|
|
If sunset is at 17:40 but `earliest` is set to 18:00, the event is moved to 18:00.
|
|
|
|
OR
|
|
|
|
If sunset at is 22:10 but `latest` is set to 21:00, the event is moved to 21:00.
|
|
|
|
## Full Example
|
|
|
|
### Things
|
|
|
|
demo.things
|
|
|
|
```java
|
|
Bridge darksky:weather-api:api "Dark Sky Account" [apikey="AAA", refreshInterval=30, language="de"] {
|
|
Thing weather-and-forecast local "Local Weather And Forecast" [location="XXX,YYY", forecastHours=0, forecastDays=8, numberOfAlerts=1] {
|
|
Channels:
|
|
Type sunset-event : current#sunset-event [
|
|
earliest="18:00",
|
|
latest="21:00"
|
|
]
|
|
}
|
|
Thing weather-and-forecast miami "Weather And Forecast In Miami" [location="25.782403,-80.264563", forecastHours=24, forecastDays=0]
|
|
}
|
|
```
|
|
|
|
### Items
|
|
|
|
demo.items
|
|
|
|
```java
|
|
DateTime localLastMeasurement "Timestamp of last measurement [%1$tY-%1$tm-%1$tdT%1$tH:%1$tM:%1$tS]" <time> { channel="darksky:weather-and-forecast:api:local:current#time-stamp" }
|
|
String localCurrentCondition "Current condition [%s]" <sun_clouds> { channel="darksky:weather-and-forecast:api:local:current#condition" }
|
|
Image localCurrentConditionIcon "Icon" { channel="darksky:weather-and-forecast:api:local:current#icon" }
|
|
Number:Temperature localCurrentTemperature "Current temperature [%.1f %unit%]" <temperature> { channel="darksky:weather-and-forecast:api:local:current#temperature" }
|
|
Number:Temperature localCurrentApparentTemperature "Current apparent temperature [%.1f %unit%]" <temperature> { channel="darksky:weather-and-forecast:api:local:current#apparent-temperature" }
|
|
Number:Pressure localCurrentPressure "Current barometric pressure [%.1f %unit%]" <pressure> { channel="darksky:weather-and-forecast:api:local:current#pressure" }
|
|
Number:Dimensionless localCurrentHumidity "Current atmospheric humidity [%d %unit%]" <humidity> { channel="darksky:weather-and-forecast:api:local:current#humidity" }
|
|
Number:Speed localCurrentWindSpeed "Current wind speed [%.1f km/h]" <wind> { channel="darksky:weather-and-forecast:api:local:current#wind-speed" }
|
|
Number:Angle localCurrentWindDirection "Current wind direction [%d %unit%]" <wind> { channel="darksky:weather-and-forecast:api:local:current#wind-direction" }
|
|
Number:Dimensionless localCurrentCloudiness "Current cloudiness [%d %unit%]" <clouds> { channel="darksky:weather-and-forecast:api:local:current#cloudiness" }
|
|
Number:Length localCurrentVisibility "Current visibility [%.1f %unit%]" <none> { channel="darksky:weather-and-forecast:api:local:current#visibility" }
|
|
Number:Speed localCurrentRainIntensity "Current rain intensity [%.2f mm/h]" <rain> { channel="darksky:weather-and-forecast:api:local:current#rain" }
|
|
Number:Speed localCurrentSnowIntensity "Current snow intensity [%.2f mm/h]" <snow> { channel="darksky:weather-and-forecast:api:local:current#snow" }
|
|
Number:Speed localCurrentPrecipitationIntensity "Current precipitation intensity [%.2f mm/h]" <rain> { channel="darksky:weather-and-forecast:api:local:current#precip-intensity" }
|
|
Number:Dimensionless localCurrentPrecipitationProbability "Current precipitation probability [%d %unit%]" <rain> { channel="darksky:weather-and-forecast:api:local:current#precip-probability" }
|
|
String localCurrentPrecipitationType "Current precipitation type [%s]" <rain> { channel="darksky:weather-and-forecast:api:local:current#precip-type" }
|
|
Number localCurrentUVIndex "Current UV index [%d]" <none> { channel="darksky:weather-and-forecast:api:local:current#uvindex" }
|
|
Number:ArealDensity localCurrentOzone "Current ozone [%.1f %unit%]" <none> { channel="darksky:weather-and-forecast:api:local:current#ozone" }
|
|
DateTime localSunrise "Sunrise [%1$tY-%1$tm-%1$tdT%1$tH:%1$tM:%1$tS]" <sun> { channel="darksky:weather-and-forecast:api:local:current#sunrise" }
|
|
DateTime localSunset "Sunset [%1$tY-%1$tm-%1$tdT%1$tH:%1$tM:%1$tS]" <sun> { channel="darksky:weather-and-forecast:api:local:current#sunset" }
|
|
|
|
DateTime localDailyForecastTodayTimestamp "Timestamp of forecast [%1$tY-%1$tm-%1$td]" <time> { channel="darksky:weather-and-forecast:api:local:forecastToday#time-stamp" }
|
|
String localDailyForecastTodayCondition "Condition for today [%s]" <sun_clouds> { channel="darksky:weather-and-forecast:api:local:forecastToday#condition" }
|
|
Image localDailyForecastTodayConditionIcon "Icon" { channel="darksky:weather-and-forecast:api:local:forecastToday#icon" }
|
|
Number:Temperature localDailyForecastTodayMinTemperature "Minimum temperature for today [%.1f %unit%]" <temperature> { channel="darksky:weather-and-forecast:api:local:forecastToday#min-temperature" }
|
|
Number:Temperature localDailyForecastTodayMaxTemperature "Maximum temperature for today [%.1f %unit%]" <temperature> { channel="darksky:weather-and-forecast:api:local:forecastToday#max-temperature" }
|
|
Number:Temperature localDailyForecastTodayMinApparentTemperature "Minimum apparent temperature for today [%.1f %unit%]" <temperature> { channel="darksky:weather-and-forecast:api:local:forecastToday#min-apparent-temperature" }
|
|
Number:Temperature localDailyForecastTodayMaxApparentTemperature "Maximum apparent temperature for today [%.1f %unit%]" <temperature> { channel="darksky:weather-and-forecast:api:local:forecastToday#max-apparent-temperature" }
|
|
Number:Pressure localDailyForecastTodayPressure "Barometric pressure for today [%.1f %unit%]" <pressure> { channel="darksky:weather-and-forecast:api:local:forecastToday#pressure" }
|
|
Number:Dimensionless localDailyForecastTodayHumidity "Atmospheric humidity for today [%d %unit%]" <humidity> { channel="darksky:weather-and-forecast:api:local:forecastToday#humidity" }
|
|
Number:Speed localDailyForecastTodayWindSpeed "Wind speed for today [%.1f km/h]" <wind> { channel="darksky:weather-and-forecast:api:local:forecastToday#wind-speed" }
|
|
Number:Angle localDailyForecastTodayWindDirection "Wind direction for today [%d %unit%]" <wind> { channel="darksky:weather-and-forecast:api:local:forecastToday#wind-direction" }
|
|
Number:Dimensionless localDailyForecastTodayCloudiness "Cloudiness for today [%d %unit%]" <clouds> { channel="darksky:weather-and-forecast:api:local:forecastToday#cloudiness" }
|
|
Number:Speed localDailyForecastTodayRainIntensity "Rain intensity for today [%.2f mm/h]" <rain> { channel="darksky:weather-and-forecast:api:local:forecastToday#rain" }
|
|
Number:Speed localDailyForecastTodaySnowIntensity "Snow intensity for today [%.2f mm/h]" <snow> { channel="darksky:weather-and-forecast:api:local:forecastToday#snow" }
|
|
|
|
DateTime localDailyForecastTomorrowTimestamp "Timestamp of forecast [%1$tY-%1$tm-%1$td]" <time> { channel="darksky:weather-and-forecast:api:local:forecastTomorrow#time-stamp" }
|
|
String localDailyForecastTomorrowCondition "Condition for tomorrow [%s]" <sun_clouds> { channel="darksky:weather-and-forecast:api:local:forecastTomorrow#condition" }
|
|
Image localDailyForecastTomorrowConditionIcon "Icon" { channel="darksky:weather-and-forecast:api:local:forecastTomorrow#icon" }
|
|
Number:Temperature localDailyForecastTomorrowMinTemperature "Minimum temperature for tomorrow [%.1f %unit%]" <temperature> { channel="darksky:weather-and-forecast:api:local:forecastTomorrow#min-temperature" }
|
|
Number:Temperature localDailyForecastTomorrowMaxTemperature "Maximum temperature for tomorrow [%.1f %unit%]" <temperature> { channel="darksky:weather-and-forecast:api:local:forecastTomorrow#max-temperature" }
|
|
...
|
|
|
|
DateTime localDailyForecastDay2Timestamp "Timestamp of forecast [%1$tY-%1$tm-%1$td]" <time> { channel="darksky:weather-and-forecast:api:local:forecastDay2#time-stamp" }
|
|
String localDailyForecastDay2Condition "Condition in 2 days [%s]" <sun_clouds> { channel="darksky:weather-and-forecast:api:local:forecastDay2#condition" }
|
|
Image localDailyForecastDay2ConditionIcon "Icon" { channel="darksky:weather-and-forecast:api:local:forecastDay2#icon" }
|
|
Number:Temperature localDailyForecastDay2MinTemperature "Minimum temperature in 2 days [%.1f %unit%]" <temperature> { channel="darksky:weather-and-forecast:api:local:forecastDay2#min-temperature" }
|
|
Number:Temperature localDailyForecastDay2MaxTemperature "Maximum temperature in 2 days [%.1f %unit%]" <temperature> { channel="darksky:weather-and-forecast:api:local:forecastDay2#max-temperature" }
|
|
...
|
|
|
|
String localAlert1Title "Weather warning! [%s]" <error> { channel="darksky:weather-and-forecast:api:local:alerts1#title" }
|
|
String localAlert1Description "Description [%s]" <error> { channel="darksky:weather-and-forecast:api:local:alerts1#description" }
|
|
String localAlert1Severity "Severity [%s]" <error> { channel="darksky:weather-and-forecast:api:local:alerts1#severity" }
|
|
DateTime localAlert1Issued "Issued [%1$tY-%1$tm-%1$tdT%1$tH:%1$tM]" <time> { channel="darksky:weather-and-forecast:api:local:alerts1#issued" }
|
|
DateTime localAlert1Expires "Expires [%1$tY-%1$tm-%1$tdT%1$tH:%1$tM]" <time> { channel="darksky:weather-and-forecast:api:local:alerts1#expires" }
|
|
|
|
String miamiCurrentCondition "Current condition in Miami [%s]" <sun_clouds> { channel="darksky:weather-and-forecast:api:miami:current#condition" }
|
|
Image miamiCurrentConditionIcon "Icon" { channel="darksky:weather-and-forecast:api:miami:current#icon" }
|
|
Number:Temperature miamiCurrentTemperature "Current temperature in Miami [%.1f %unit%]" <temperature> { channel="darksky:weather-and-forecast:api:miami:current#temperature" }
|
|
...
|
|
|
|
String miamiHourlyForecast01Condition "Condition in Miami for the next hour [%s]" <sun_clouds> { channel="darksky:weather-and-forecast:api:miami:forecastHours01#condition" }
|
|
Image miamiHourlyForecast01ConditionIcon "Icon" { channel="darksky:weather-and-forecast:api:miami:forecastHours01#icon" }
|
|
Number:Temperature miamiHourlyForecast01Temperature "Temperature in Miami for the next hour [%.1f %unit%]" <temperature> { channel="darksky:weather-and-forecast:api:miami:forecastHours01#temperature" }
|
|
...
|
|
String miamiHourlyForecast02Condition "Condition in Miami for hours 1 to 2 [%s]" <sun_clouds> { channel="darksky:weather-and-forecast:api:miami:forecastHours02#condition" }
|
|
Image miamiHourlyForecast02ConditionIcon "Icon" { channel="darksky:weather-and-forecast:api:miami:forecastHours02#icon" }
|
|
Number:Temperature miamiHourlyForecast02Temperature "Temperature in Miami for hours 1 to 2 [%.1f %unit%]" <temperature> { channel="darksky:weather-and-forecast:api:miami:forecastHours02#temperature" }
|
|
...
|
|
```
|
|
|
|
### Sitemap
|
|
|
|
demo.sitemap
|
|
|
|
```perl
|
|
sitemap demo label="Dark Sky" {
|
|
Frame label="Local Weather Station" {
|
|
Text item=localStationId
|
|
Text item=localStationName
|
|
Mapview item=localStationLocation
|
|
}
|
|
Frame label="Current local weather" {
|
|
Text item=localLastMeasurement
|
|
Text item=localCurrentCondition
|
|
Image item=localCurrentConditionIcon
|
|
Text item=localCurrentTemperature
|
|
Text item=localCurrentApparentTemperature
|
|
Text item=localCurrentPressure
|
|
Text item=localCurrentHumidity
|
|
Text item=localCurrentWindSpeed
|
|
Text item=localCurrentWindDirection
|
|
Text item=localCurrentCloudiness
|
|
Text item=localCurrentVisibility
|
|
Text item=localCurrentRainIntensity
|
|
Text item=localCurrentSnowIntensity
|
|
Text item=localCurrentPrecipitationIntensity
|
|
Text item=localCurrentPrecipitationProbability
|
|
Text item=localCurrentPrecipitationType
|
|
Text item=localCurrentUVIndex
|
|
Text item=localCurrentOzone
|
|
Text item=localSunrise
|
|
Text item=localSunset
|
|
}
|
|
Frame label="Local forecast for today" {
|
|
Text item=localDailyForecastTodayTimestamp
|
|
Text item=localDailyForecastTodayCondition
|
|
Image item=localDailyForecastTodayConditionIcon
|
|
Text item=localDailyForecastTodayMinTemperature
|
|
Text item=localDailyForecastTodayMaxTemperature
|
|
Text item=localDailyForecastTodayMinApparentTemperature
|
|
Text item=localDailyForecastTodayMaxApparentTemperature
|
|
Text item=localDailyForecastTodayPressure
|
|
Text item=localDailyForecastTodayHumidity
|
|
Text item=localDailyForecastTodayWindSpeed
|
|
Text item=localDailyForecastTodayWindDirection
|
|
Text item=localDailyForecastTodayCloudiness
|
|
Text item=localDailyForecastTodayRainIntensity
|
|
Text item=localDailyForecastTodaySnowIntensity
|
|
}
|
|
Frame label="Local forecast for tomorrow" {
|
|
Text item=localDailyForecastTomorrowTimestamp
|
|
Text item=localDailyForecastTomorrowCondition
|
|
Image item=localDailyForecastTomorrowConditionIcon
|
|
Text item=localDailyForecastTomorrowMinTemperature
|
|
Text item=localDailyForecastTomorrowMaxTemperature
|
|
...
|
|
}
|
|
Frame label="Local forecast in 2 days" {
|
|
Text item=localDailyForecastDay2Timestamp
|
|
Text item=localDailyForecastDay2Condition
|
|
Image item=localDailyForecastDay2ConditionIcon
|
|
Text item=localDailyForecastDay2MinTemperature
|
|
Text item=localDailyForecastDay2MaxTemperature
|
|
...
|
|
}
|
|
Frame label="Severe weather alerts" {
|
|
Text item=localAlert1Title
|
|
Text item=localAlert1Description
|
|
Text item=localAlert1Severity
|
|
Text item=localAlert1Issued
|
|
Text item=localAlert1Expires
|
|
}
|
|
Frame label="Current weather in Miami" {
|
|
Text item=miamiCurrentCondition
|
|
Image item=miamiCurrentConditionIcon
|
|
Text item=miamiCurrentTemperature
|
|
...
|
|
}
|
|
Frame label="Forecast in Miami for the next hour" {
|
|
Text item=miamiHourlyForecast01Condition
|
|
Image item=miamiHourlyForecast01ConditionIcon
|
|
Text item=miamiHourlyForecast01Temperature
|
|
...
|
|
}
|
|
Frame label="Forecast weather in Miami for the hours 1 to 2" {
|
|
Text item=miamiHourlyForecast02Condition
|
|
Image item=miamiHourlyForecast02ConditionIcon
|
|
Text item=miamiHourlyForecast02Temperature
|
|
...
|
|
}
|
|
}
|
|
```
|
|
|
|
### Events
|
|
|
|
```php
|
|
rule "example trigger rule"
|
|
when
|
|
Channel "darksky:weather-and-forecast:api:local:current#sunrise-event" triggered START or
|
|
Channel "darksky:weather-and-forecast:api:local:current#sunset-event" triggered START
|
|
then
|
|
...
|
|
end
|
|
```
|
|
|
|
[](https://darksky.net/poweredby/)
|