Web Services in the U.S. Geological Survey StreamStats Web Application

1
Web Services in the U.S. Geological Survey
StreamStats Web Application
U.S. Department of the Interior U.S. Geological
Survey
2

• GEOWS 2009
• Session Web Services Geospatial Systems
• February 03, 2009 1030 1215
• John D Guthrie
• USGS Geography Discipline, Denver,
  COjdguthrie_at_usgs.gov
• Christine Dartiguenave, ESRI
• cdartiguenave_at_esri.com
• Kernell G. Ries III
• USGS Water Discipline, Baltimore,
  MDkries_at_usgs.gov

U.S. Department of the Interior U.S. Geological
Survey
3
Outline

• Brief Description of StreamStats
• The Benefits of using Web Services
• Web Services Used by StreamStats
• Web Services Provided by StreamStats

4
StreamStats Web Application

• Provides published streamflow statistics, basin
  and climatic characteristics, and other
  information for data-collection stations
• Allows users to select points on ungaged streams.
  Using GIS at this location
• Computes the basin-drainage boundary
• Measures the drainage-basin characteristics for
  the computed basin-drainage boundary
• Estimates Flows at the requested point using
  regression equations

5
http//streamstatsags.cr.usgs.gov/ut_ss/index.htm
6
http//streamstatsags.cr.usgs.gov/nc_ss/index.htm
7
Uses of Streamflow Statistics

• Design of structures such as roads, bridges,
  culverts, dams, locks, and levees
• Water resources planning and management
• Flood-plain mapping for zoning and insurance rate
  setting
• Instream flow determinations for pollution
  control and habitat protection
• Design and permitting of facilities such as
  wastewater-treatment plants, hydropower plants,
  and water-supply reservoirs

8
StreamStats Benefits

• Cost Time to delineate drainage boundaries and
  compute basin characteristics is reduced from
  hours to minutes
• Accuracy Measurement errors not introduced
  some measurements much better others about the
  same as manual methods
• Consistency Important for statistical validity
• Accessibility Special equipment and/or
  expertise not needed to obtain estimates

9
Ungaged Site Process

• User selects point on stream network
• Point is transferred to a cell in a
  flow-direction grid derived from a DEM ? DEM
  usually is preprocessed to conform to mapped
  streams and previously determined drainage
  boundaries
• GIS determines drainage boundary and presents it
  for review in map frame
• Boundary can be edited if errors are found
• GIS computes drainage area and other basin
  characteristics
• Basin characteristics are inserted into
  regression equations to compute flow estimates
• Basin characteristics can be edited if errors are
  found
• Flow estimates appear in pop-up window with error
  estimates
• Network Navigation can be performed on some
  states

10
StreamStats Web Application

• Current implementation status by state

11
StreamStats Web Application

• Web Application usage statistics

12
StreamStats Web Application

• Web Application usage statistics

13
What are Web Services?

• The W3C defines a Web Service as a software
  system designed to support interoperable Machine
  to Machine interaction over a network.

14
What are Web Services?

• Web Services provide the means for software to
  connect to other software applications in order
  to build distributed, service-oriented systems

15
Web Service Benefits

• Allows applications to remotely access the
  functionality of another system
• Reduces duplication of effort
• In data collection and processing
• Typical StreamStats state application
• requires 50-75 GB storage
• Conversion from ArcIMS to ArcGIS Sever took 2 ½
  yrs

16
StreamStats Web Servicesare RESTful
17
RESTful Web Services

• Are simple Web Services
• Implemented using HTTP
• Uses the principals of REST
• representational state transfer"
• Introduced in 2000 by Roy Fielding

18
Web Services used by StreamStats

NHD Web Services
Zoom to Reach/Measure
StreamStats Application
GNIS Web Services
Zoom to Place Name
National Hydrography Dataset Geographic
Names Information System
19
Web Services used by StreamStats

• Zoom To reach code

20
Web Services used by StreamStats
21
Web Services used by StreamStats

• Zoom To NHD reach and measure

22
Web Services used by StreamStats

• NHD Web Services
• Send Request to NHD Server
• http//rockys97/NHDService/Service.asmx/NHDlatlong
  ?reach16020201000056measure25
• NHD Returns
• lt?xml version"1.0" encoding"utf-8" ?gt
•   ltstring xmlns"http//tempuri.org/"gt
• -111.80355,39.71302lt/stringgt

23
(No Transcript)
24
Web Services used by StreamStats

• Zoom To place name

25
Web Services used by StreamStats
26
Web Services used by StreamStats
27
Web Services used by StreamStats
28
Web Services used by StreamStats

• GNIS Web Services

StreamStats
The National Map
29
Web Services used by StreamStats

• Benefits of using NHD and GNIS
• StreamStats does not need to maintain a copy of
  the data
• StreamStats does not have to maintain the code
• Shorter development time

30
Web Services provided by StreamStats

• The First StreamStats Web Service
• Developed in 2007 using ArcGIS Server 9.1
• Follows Open Geospatial Consortium Standards for
• Geography Markup Language

Boundary Delineation
KWMIP
StreamStats Web Services
Climate Data
Kentucky Watershed Modeling Information Portal
31
Web Services provided by StreamStats

• First StreamStats Web Service

32
Web Services provided by StreamStats

• StreamStats Web Services used by KWMIP

33
Web Services provided by StreamStats

• StreamStats Web Services used by KWMIP

34
Web Services provided by StreamStats

• StreamStats Web Services used by KWMIP

35
Web Services provided by StreamStats

• StreamStats Current Web Services
• Use ArcGIS 9.2
• Follow FIPSPUB 5-2 for State Abbreviations
• Use the Coordinate Reference System as defined
  OGC and EPSG Geodesy Parameters V 6.6
• Provide increased tool capability
• Watershed Delineation
• Basin Characteristics
• Flow Statistics
• Download

36
Web Services provided by StreamStats

• StreamStats Current Web Services
• Output Formats
• Extensible Markup Language (XML)
• Keyhole Markup Language (KML)
• Serialized ArcObjects (ESRI ArcGIS 9.2)
• Geography Markup Language (GML) will be available
  soon
• See users instructions at http//streamstats.usgs
  .gov/webservices/

Use of trade, product, or firm names is for
descriptive purposes only and does not imply
endorsement by the U.S. Government.
37
Web Services provided by StreamStats
Note HTTP POST is not working externally at this
time.
38
Web Services provided by StreamStats

• HTTP GET Format

http//streamstatsags.cr.usgs.gov/ss_ws_92/Service
.asmx/getStreamstats?x-111.1563y39.4725inCRSE
PSG6.64326StateNameAbbrUTgetBasinCharsCgetF
lowStatsCgetGeometryKMLdownloadFeatureFalsec
lientIDUT20Demo
39
Web Services provided by StreamStats

• What the request does
• Computes the basin-drainage boundary at the X and
  Y point requested
• Measures the drainage-basin characteristics for
  the computed basin-drainage boundary
• Estimates Flows at the requested point using
  regression equations
• Projects the points and polygon to WGS84
• Generates a KML file

40
Web Services provided by StreamStats
41
Web Services provided by StreamStats

• Save as .kml file

42
Web Services provided by StreamStats
43
Web Services provided by StreamStats
44
Web Services provided by StreamStats
45
Web Services provided by StreamStats
46
Web Services provided by StreamStats

• StreamStats Web Service uses
• StreamStats internal testing
• For new state applications
• Different versions of StreamstatsDB an NSS
• Batch processing by Engineers
• Requests from Engineering Companies in Colorado,
  Indiana and Oregon
• Web Applications
• Kentucky Watershed Modeling Information Portal

47
Web Services provided by StreamStats

• Potential StreamStats Web Service uses
• Indiana State Web Application
• Burned Area Emergency Response (BAER)
• Wildland Fire Decision Support System (WFDSS)
• Input into USGS Modeling efforts
• Global Climate Change
• Land Use Change
• USGS Projects
• Grand County Fire Science
• MA Safe Yield Estimator
• EPAs EnviroMapper

48
StreamStats Web Application

• Current web service status by State

49
StreamStats Web Application

• Batch Processing Tool
• A tool is under current development as a desktop
  application
• Will be able to download the tool
• Input shapefile of points
• Must be snapped to the stream grid
• Projection must be defined
• Output shapefile of basin delineations
• Can include Basin Characteristics
• Can include Flow Statistics

50
StreamStats Web Application

• Batch Processing Tool

51
Questions?
http//StreamStats.usgs.gov/webservices/
52

• GEOWS 2009
• Session Web Services Geospatial Systems
• February 03, 2009 1030 1215
• John D Guthrie
• USGS Geography Discipline, Denver,
  COjdguthrie_at_usgs.gov
• Christine Dartiguenave, ESRI
• cdartiguenave_at_esri.com
• Kernell G. Ries III
• USGS Water Discipline, Baltimore,
  MDkries_at_usgs.gov

U.S. Department of the Interior U.S. Geological
Survey