USGS EDDN Agent
Copyright © 2018 EarthSoft, Inc • Modified: 12 Dec 2018
The United States Geological Survey (USGS) Emergency Data Distribution Network (EDDN) Agent is a data loading agent available in EQuIS Live for obtaining sensor data from USGS EDDN web API.
Before using the USGS EDDN 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 USGS-EDDN.
3.Set LOGGER_CODE to an 8 hex digit DCP Address (e.g., 1A2B3C4D). Note, these are not available to the general public.
4.Set STATUS_FLAG to 'A' to activate the logger.
The USGS EDDN Agent or Historical Data Loader can be run as a scheduled EQuIS Information Agent (EIA), at the desired frequency, to automatically load data as often as needed.
The USGS EDDN Agent or Historical Data Loader 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 USGS EDDN Agent will load values for all loggers with LIVE_DATA_SOURCE set to USGS-EDDN.
When the report is run initially, the agent will retrieve values from a logger's site (DT_LOGGER.LOGGER_CODE) for the past one month. If data has been previously loaded for that logger, the agent will request data from the logger's most recent date (in DT_LOGGER_DATUM.DATUM_UTC_DT) until today's date.
The USGS EDDN Historical Data Loader allows you to select the loggers and date range. It has the following input parameters:
•Logger(s) – Select the stations from which you want to load data. If no stations are selected, the agent will load data for all USGS EDDN stations.
•Date Range – Select a date range; choose from recent, period, or start and end dates. The recent option works the same way as the USGS EDDN Agent. If you select the period option, you must enter a period in ISO-8601 duration format. If you select the start and end dates option, you must select start and end dates.
•Update existing values? – Check this box to update existing EQuIS Live data values.