Table Of Content¶

Plugin weather¶

Purpose¶

The weather plugin uses the online service Yahoo! Weather to grab weather informations.

Dependencies¶

There is no dependency.

Plugin configuration¶

There is no global configuration options for this plugin.

Create the domogik devices¶

Domogik device type : weather.weather¶

1 parameter is needed for a domogik device creation:

Key	Type	Description
device	string	The location code for your city. Example for Paris : 615702

To find the location code for your city, just go on https://weather.yahoo.com/ . Then, search for your town. You will be redirected to a new page with an url like this : https://weather.yahoo.com/france/%C3%AEle-de-france/paris-615702/ (for Paris). The last part of the url, after the “-” (minus) is the location code. In our example, the location code for Paris is 615702.

Start the plugin¶

You can now start the plugin (start button) and use the created domogik devices.

Set up your widgets on the user interface¶

You can now place the widgets of your devices features on the user interface.

Development informations¶

Sensors history¶

Most of the sensors for this plugin have no history enabled by default. For example forecast data have no history as there is no need to keep forecast history!

Only the following sensors are configured to store the history:

current_barometer_value
current_humidity
current_temperature
current_wind_direction
current_wind_gust
current_wind_speed

Timeout on sensors¶

All sensors have a timeout set to 65 minutes : as the interval between each check on weather.com is set to 30min, we let the plugin to encounter 1 failure.

Forecast data¶

A specific xPL schema has been defined for the forecast:

xpl-stat

xpl-stat
{
...
}
weather.forecast
{
    provider=yahoo weather
    day=<number of the day : 0....>
    day-name=...
    temperature-high=...
    temperature-low=...
    condition-text=...
    condition-code=...
}

Condition codes¶

Condition codes and texts are listed here: https://developer.yahoo.com/weather/documentation.html

You can find some code to translate the condition codes to css class for a weather css icon library here : https://gist.github.com/aloncarmel/8575527