<< Click to Display Table of Contents >> Navigation: Live > Agents > Web API Agents > Web API Open Data > Live Australian BoM WDS Agent |
Report Name: EQuIS Live: Australian BoM WDS Agent
File Name: EarthSoft.Live.Reports.dll
Description: The EQuIS Live: Australian Bureau of Meteorology (BoM) Weather Data Services (WDS) Agent report allows users to retrieve weather data from the Australian BoM WDS in EQuIS Professional and Enterprise.
Tables: DT_LOGGER, DT_LOGGER_SERIES, DT_LOGGER_DATUM
Important Note: The EQuIS 7.22.1 Build or later is required to get data from Australian BoM WDS's FTP site (e.g., ftp://ftp.bom.gov.au/anon/gen/fwo/IDD60910.tgz/IDD60910.94153.json). Earlier EQuIS builds can only get data from Australian BoM WDS's web API (e.g., http://www.bom.gov.au/fwo/IDD60801/IDD60801.94153.json), which may get blocked by the Australian BoM WDS. For more info see Service Announcements: 'The Bureau is monitoring screen scraping activity on the site and...blocking this activity...' |
---|
Before running this report, one or more stations must be added to the DT_LOGGER table:
1.Add the station (DT_LOGGER row) in EQuIS Professional.
2.Set the LIVE_DATA_SOURCE to ftp://ftp.bom.gov.au/anon/gen/fwo/ID{x}60910.tgz/ID{x}60910.{WMO ID}.json, where:
a.{x} is a letter representing the station's state or territory (see the table below), and
b.{WMO ID} is the station's WMO ID (which can be obtained by going to Australian BoM WDS: Observations - individual stations and following the instructions to "get the URL of a data feed for a weather station". For example, Groote Eylandt Airport's URL is http://www.bom.gov.au/fwo/IDD60801/IDD60801.94153.json, and its WMO ID is 94153).
State / Territory |
.tgz File |
---|---|
Queensland |
IDQ60910.tgz |
New South Wales / Australian Capital Territory |
IDN60910.tgz |
Northern Territory |
IDD60910.tgz |
South Australia |
IDS60910.tgz |
Tasmania |
IDT60910.tgz |
Victoria |
IDV60910.tgz |
Western Australia |
IDW60910.tgz |
Notes: •This report only allows one station per logger, and only supports JSON, not AXF or XML. •The .tgz files are updated every 30 minutes. |
3.Set LOGGER_CODE to anything (e.g., the station name); this field is not used, but cannot be NULL.
4.Set STATUS_FLAG to "A" to activate the logger.
This report will automatically add the series (and datum) when it runs. However, some of the stations may not have one or more of the series listed below, in which case those series will not be added.
SERIES_NAME |
SERIES_UNIT |
---|---|
air_temp |
deg C |
apparent_t |
deg C |
cloud_base_m |
m |
cloud_oktas |
|
delta_t |
deg C |
dewpt |
deg C |
gust_kmh |
km/h |
gust_kt |
knots |
press |
hPa |
press_msl |
hPa |
press_qnh |
hPa |
rain_hour |
mm |
rain_ten |
mm |
rain_trace |
mm |
rel_hum |
% |
vis_km |
km |
wind_dir_deg |
deg |
wind_spd_kmh |
km/h |
wind_spd_kt |
knots |
A series can then be activated or deactivated, by setting its STATUS_FLAG = 'A' or 'R', to start or stop (respectively) obtaining data for it. Also, the SERIES_UNIT and SERIES_DESC for a series may be changed, but not its SERIES_NAME; it uniquely identifies the series.
This report can be run manually or as scheduled EQuIS Information Agent (EIA), at the desired frequency, to automatically load data as often as needed. It will load data for all loggers with LIVE_DATA_SOURCE containing bom.gov.au.
Copyright © 2023 EarthSoft, Inc • Modified: 04 Mar 2022