Water Web Services

Connecting a Catalog withUsers and Servers

Server User

Catalog

Data Services

Search ServicesMetadata Service

s HydroServer HydroDesktop

HIS Central

Data Services

Search ServicesMetadata Service

s

WISKI ArcGIS Desktop

HIS Central

Data Services

Search ServicesMetadata Services

A general pattern ….

is implemented in different ways ….

Mapping the Catalogs

Server User

Catalog

Server User

Catalog

Server User

Catalog

Server User

Catalog

Server User

Catalog

Data Services

Search ServicesMetadata Service

s

Water observation sites in a catalog are mapped …..

….. a map in ArcGIS Online serves as an integrating mechanism for water observations over the earth

Mapping Services

Original Water Web Service

• Get Sites• Get Site Info (Series)• Get Variables• Get Values

More than just time series over SOS

• Services/Data Sources– 10’s to 1000’s

• Sites– 1 to 1 million

• Phenomena– 1 to 10,000

• Series– 10’s to millions– Site, Phenomena, Data Type, statistics, Time Range, Count– quality control level (1+) source (1+), method (1+)

• Domain– Organizations, Methods, QC, Units

• Data– date, value, censored, quality control level, source, method, qualifier (1+), sample code

• Analytical Chemistry Details– WQX

Services (1/2)• Sites

– Map them• WFS• WMS – too many to send over wfs• Together. WMS with paged WFS

• Phenomena– Describe

• What variables are available

– Discover• What sites in area have this phenomena

• Series– Discover them

• CSW• What sites in area have this phenomena

– With this time period– Spacing– Squlity, method

• Show me the best quality

– Map them• WFS+WMS

– Give me all

Services (2/2)• Domain– Organizations, Methods, QC, Units, Ontologies

• Data– SOS– WaterML 2

• Analytical Chemistry Details– Fixed URL reference?– WQX

Possible Method Naming Convention

• List• Describe• Get

Water Web Services

Mega Server

Water Web Data Services Client

Water Web Catalog Service

Data Services

Search ServicesList, Describe

Metadata Services

Get

Water QualityExchange Services

Utilizing WQX

Refe

renc

e to

An

alyti

cal

Met

adat

a

Analytical Chem Details

Water Web Data Services Client

Water Web Catalog Service

Data Services

Search ServicesMetadata Services

Mapping Services

Authorization Service

Additional Components

User Authorized

Can User Access Item

Login

(Aut

henti

cate

)Us

er A

utho

rizati

on To

kenUser Authorization Token

Search ResultsIm

age of Search Results

Water Web Service Capability

• Describes Services– Water Web Data Services– Water Web Catalog Service– Water Quality Exchange Service– Water Web Ontology Service– Map Services

Water Web Data Service

• Harvest (List) • Single object access (Describe)• Basic query (Get)• Objects

– Services– Domains– Series– Sites– Variables– Data Values

• Pointer to Map Service (optional)

Water Quality Exchange

• Standardized access to Water Quality Exchange Services

• Utilize WQX standard for the details of analytical chemistry observations

• Organizations– Projects• Activities

– Methods» Results

Water Web Catalog Services

• Search interface, not a harvest interface• Utilize same queries to retrieve “objects”• Return reference to map services for appropriate object

queries (features and series) • Objects

– Services– Domains– Series– Features– Variables

• Provide Map Services for services

Catalog Query Parameters

• Paging: count, startindex• Location: box, siteCode, polygon• Variables: VariableCode• Ontology: conceptCode• Series: SeriesCode• Time: BeginTIme, EndTime• Updated: lastmodified• DataService: DataService• DataType: DataType• Theme: Theme Code, Theme Name• Search by name: SearchTerms

Queries• Variable– For box, pass a bbox– For a set of sites or series, pass multiple site or series

codes• Series– For box, pass a bbox– For a set of a concept, pass a concept code from the

ontology• Services– For box, pass a bbox– For a set of a concept, pass a concept code from the

ontology

Water Web Ontology Services

• Handle Multiple Ontologies• List Terms for an ontology (domains)• Provide hierarchies/relationships for an

ontology (conceptTree).• Provide method for user interfaces • Provide method to assist with matching

variable name to concept(s)

Map Services

• Data Services should provide a Web Map Service to plot their location on a map.

• Well known features need to provide Web Map Service, and Web Feature Services. Examples of this would be HUC’s, and state and county boundaries.

Authentication and Authorization

• Use standards– OpenId for Authentication

• We don’t store passwords, in general

– Oauth for Authorization• Servers needing restricted data provide authorization

service– Level is up to server. Auth service should only know about Object

Identifiers• Clients

– When access is rejected, clients need to know how to authenticate to an authorization service

– Pass authorization