Weather Underground Widget

<< Click to Display Table of Contents >>

EQuIS 7  >>  Enterprise > EQuIS Live > Widgets >

Weather Underground Widget

The Weather Underground widget allows new stations to be added to the database, as well as activate/deactivate stations already in the database. These are stored in DT_LOGGER, DT_LOGGER_SERIES. An API (Application Programming Interface) key is needed to add stations. One can be obtained with a paid subscription at http://www.wunderground.com/weather/api/. Once obtained, enter the API key through the Widget Editor.

 

Live-Weather_Underground_Widget-Output

 

The top section of the Weather Underground widget is used for adding new stations. If a station is entered that has already been added, the data will be updated. The lower section contains a tree of all stations currently in the database. Browse through the tree to see which stations are active or inactive. Beneath each station logger node are related series nodes. These are the data fields that will be available after data are collected using the Weather Underground Agent.

 

Add Station

Live-Weather_Underground_Widget-Add_Station

To add a station, enter the Station ID into the Station ID box at the top of the widget and click Add. If the add is successful, the box will be cleared. The tree below will also reload to show the new station. Examples of what can be entered as a station ID are shown below (and also available as a tooltip by hovering over the Station ID box). There is support for:

US state/city

US zip code

Country/city

Latitude, longitude (format: latitude/longitude with no space)

Airport code

Private weather station ID

Autoip

Autoip to a specific IP address

 

The station names are a combination of the public name (e.g., CA/San_Francisco), which should match what was entered in the station ID box, and the private station name (e.g., KCASANFR58), separated by a '#'.

 

 

Activate / Deactivate Stations

 

A station that shows the green icon Live-Logger-Green_Add is currently registered and active in EQuIS Live, and data are being automatically loaded into EQuIS Live. Right-click an active station logger node and select Deactivate to stop loading data from that station. Existing data will remain in the EQuIS Live database, but no new data will be loaded until the station is activated again.

 

A station that shows the red add icon Live-Logger-Red_Remove is not currently active. This can be because the station has never been added to the EQuIS Live system or the station was added previously, but is currently inactive (no data are being loaded). Right-click the station logger node and select Activate to activate the station and begin loading data.

 

 

Widget Editor

 

The Widget Editor is used to enter the API Key needed to use the Weather Underground widget. To open the Widget Editor, select the More Options Live-More_Options-Icon icon in the upper right corner of the widget to open the drop-down menu and then select the Edit menu option.

Widget Title – By default, the widget title is EQuIS Live - Weather Underground. The title can be modified.

Widget Color – The color of the widget can be changed using the Change Widget ThemeLive-Widget-Color-Iconicon to the left of the widget title.

Cancel – Select the Close without Saving Live-Widget-Close-Icon button to exit the Widget Editor without saving changes.

Save – Changes will be applied to the widget by clicking on the Save Live-Widget-Save-Icon button. The Widget Editor screen will close after the save operation is complete.

 

Live-Weather_Underground_Widget-Editor

 

If an API key has already been entered, an API Key Saved message will be displayed at the bottom of the Widget Editor.

 

Complete the following steps to enter an API key:

1.Enter the key in the API Key box.

2.Check the Save/Clear API Key box.

3.Click the Save Live-Widget-Save-Icon button in the widget header.

 

For security reasons, the API key will not be shown once it is saved. The API key is also encrypted when stored in the database, and the URL used to obtain data contains ${api_key} instead of the actual key.

 

Complete the following steps to remove an API key:

1.Enter the key in the API Key box.

2.Check the Save/Clear API Key box.

3.Leave the API Key box empty.

4.Click the Save Live-Widget-Save-Icon button in the widget header.