Introduction

The Weather plugin is a ​Luup component that captures, displays, and periodically updates Temperature and Humidity data based upon Vera's current ​Location.

How does it work

Each user must register with ​Weather Underground to obtain a key. The plugin, when configured with the key, uses the Latitude / Longitude values configured in Vera's ​Location settings, and data provided by the Weather Underground (WUI) data feed, to retrieve:

• Temperature - The Current temperature
• Low Temperature - The estimated low temperature
• High Temperature - The estimated high temperature
• Humidity - The estimated humidity

Each of these values is presented as a Child Device of the Weather plugin, implementing the respective ​UPnP Service. They're all set to be visually grouped in the UI/Presentation.

Behind the scenes, the plugin uses Vera's Latitude and Longitude values, derived from the User-specified ​Location settings, to help form a URL to the Weather Underground (WUI) API. The user also has the option of explicitly specifying a location string within the Plugin itself.

The URL calls to WUI look like:

​https://api.wunderground.com/api/{''key''}/conditions/forecast/q/{''lat''},{''long''}.xml OR;

​https://api.wunderground.com/api/{''key''}/conditions/forecast/q/{''location''}.xml

The plugin selects elements from the XML output, and translates them into values that are set upon the respective Child Devices.

The Weather plugin retrieves the Weather data at startup and, by default, every 30 minutes after that.

Installation

• For UI2/3 Installation, please follow the UI2/3 Installation procedure
• For UI4 Installation, please follow the UI4 Installation procedure

Scene Scripting

The Weather Plugin exposes a number of Variables, as is illustrated in the Install instructions. These variables can be accessed in Luup scenes using code illustrated here:

• ​http://wiki.micasaverde.com/index.php/Luup_Variables#Weather_Plugin

Further examples can be found in the Discussion area referenced below.

Discussion

The Weather plugin is discussed in this forum thread, along with a lot of it's development history:

​http://forum.micasaverde.com/index.php?topic=1435.0

Feel free to ask questions on that thread, as well as make any suggestions & contributions to the future development of the Weather plugin's functionality.