<< Click to Display Table of Contents >> Navigation:  Live > Agents > Web API Agents > Web API Open Data > Live Weather Canada Agent

The Weather Canada Agent is a data loading agent available in EQuIS Live for obtaining weather data from the dd.weather.gc.ca web API.

 

Adding Station

 

Before using the Agent, add one or more stations to the DT_LOGGER table:

1.Execute the equis.get_ids stored procedure to get a new LOGGER_ID, or add the station (DT_LOGGER row) in EQuIS Professional.

2.Set LIVE_DATA_SOURCE to http://dd.weather.gc.ca/.

3.Set LOGGER_CODE to a 2 letter province code, followed by a dash, and an MSC number from this file (e.g., ON-6139527).

4.Set STATUS_FLAG to 'A' to activate the logger.

 

Loading Data

 

The Weather Underground Agent can be run as a scheduled EQuIS Information Agent (EIA), at the desired frequency, to automatically load data as often as needed.

 

The Weather Underground Agent can also be run in EQuIS Professional or Enterprise (using the EZView widget) to load the data manually, without having to schedule an EIA.

 

The Agent will load data for all loggers with LIVE_DATA_SOURCE set to http://dd.weather.gc.ca/. The agent will request data from the logger's most recent date (in DT_LOGGER_DATUM.DATUM_UTC_DT) until today's date. If a logger has no values, it gets values for the past day. It does not have any input parameters.

 

A series can be activated or deactivated, by setting its STATUS_FLAG = "A" or "R", to start or stop (respectively) obtaining data for it. A series' SERIES_DESC may be changed, but not the SERIES_NAME and SERIES_UNIT; they uniquely identify the series using the parameter names and units from the Weather Canada API.