STORET Web Services
STORET now provides a suite of web services which provide direct access to data in the STORET Warehouse.
Please Note: These services have been revised as of February 8, 2008.
Revisions to the web services include enhancements in performance, additional web
methods, and enhanced request parameters. Please refer to the revised STORET
Web Services Consumption User Guide (see link below) for a description of the revised services.
What is a web service?
- A web service is a computer-to-computer protocol that allows for the direct sharing of information.
- With the STORET web services, applications may access data directly from the
STORET Warehouse without needing an authorized database connection.
- The STORET web services have different input parameters and pre-defined output formats.
The following list describes the most current web services available and each service's endpoint and output schema.
The service endpoints provide the WSDL (Web Service Definition Language) for each service as well
as the different operations and web methods each service supports. The output
schemas are a machine readable formal definition of the schemas that each service
will return as output. Please refer to the revised
STORET Web Services Consumption User Guide (PDF 641 KB)
for a full description of the services, including the required input parameters, as well as
examples of how to consume them from other applications.
Please note this document is draft and may be changed as the services are further tested and used.
This spreadsheet tool (ZIP 269 KB) allows users to
interact dynamically with the STORET web services. When opening the tool in Excel, make sure to enable macros in order for the tool to function.
Name and Description of Web Service
End Point and Output Schema of the Web Service
Watershed Summary Web Service
The Watershed Summary Web Service provides summary information
for the types of data (Organizations with data, number of stations,
result counts by characteristic type, etc) available within
a given watershed (8-digit HUC).
*The Watershed Summary Tool
is an example of an application that uses the Watershed Summary Web Service.
Watershed Summary Web Service Output Schema (1KB ZIP)
Station Catalog Web Service
The Station Catalog Web Service provides station summary
information such as station name, period of record, and result
counts by characteristic type.
*The Watershed Summary Tool
is an example of an application that uses the Station Catalog Web Service.
Station Catalog Web Service Output Schema (2KB ZIP)
Project Catalog Web Service
The Project Catalog Web Service provides project summary
information such as the period of record, characteristics
monitored, and station names.
Project Catalog Web Service Output Schema (2KB ZIP)
Station Web Service
The Station Web Service provides information for all monitoring
locations within a given geographic area (geographic bounding box).
*Please Note: The Station Web Service has been revised (as of February 8, 2008)
into multiple web methods that provide enhanced data return.
These new methods allow users to quickly pull station locations
for mapping, return station counts for a given geographic area,
or obtain detailed station information if desired.
Station Web Service Output Schema (3KB ZIP)
STORET Result Web Service
The STORET Result Web Service provides direct access to STORET results.
*Please Note: The Result Web Service has been revised
(as of February 8, 2008) to provide for faster data retrieval.
Results may now be requested via latitude/longitude parameters,
or by the type of characteristic a user is searching for.
Please note that to ensure good scalability and availability,
the result output returned by the Web Service is configured to
be restricted by a maximum number of results (20,000).
If the number of results requested exceeds the maximum limit,
then the web method will notify the end user to narrow down
the search criteria in order to reduce the number of results requested.
Please refer to the draft STORET Web Services Consumption User Guide
(PDF 641 KB) for a full description of the STORET Result Web Service.
STORET Result Web Service (5KB ZIP)
|You will need Adobe Acrobat Reader to view the Adobe PDF files on this page. See EPA's PDF page for more information about getting and using the free Acrobat Reader.|