Eventdata Web Service


Description Usage URL Builder Help

The eventdata service provides access to time series data for the pre-assembled time series associated 
with a specific event. The event is specified by two identifiers:
        An eventid.
        A catalog that identifies the source of the eventid.
Together, the eventid and catalog identify a unique event to the web service.

You can optionally specify a more restricted time interval for the time series in the event gather, either globally 
(for all time series), or for any specific time series.

You can optionally select a subset of the pre-assembled time series by specifying a list of SEED network, station, 
location, and channels, and optionally a restricted time range for the data channels.  If you do not specify any 
data channels, all data channels assembled for the event will be returned.

Data are returned in miniSEED format.

GET Usage:

The simplest way to use the web service is to construct a URL that contains the web service and its
arguments.  All arguments must be specified as keyword-value pairs in the URL.  You man specify a single
restrictive starttime and endtime, and may specify a subset of the data channels using the network,
station, channel, and location keywords.  The values may be a comma-separated list, and may contain wilcards.
If no data channels are specified, all pre-assembled data channels for the event will be returned.
Example:
    /ncedcws/beta-eventdata/1/query?eventid=72099881&catalog=NCSS

POST Usage:

Alternately, instead of providing parameters-value pairs in the URL, a file containing the parameters can be POSTed 
to this service. For the POST method, all parameters must be submitted as part of the POST body.  POST requests 
should be sent as plain text and should not be formatted as application/x-www-form-urlencoded or multipart/form-data.

POST submission:  All info must be provided in the POST input.
 Required:      eventid=event_id (eg 72099881)
 Required:      catalog=event_catalog (eg NCSS, EGS, ...)
 Optional:      starttime=yyyy-mm-ddThh:mm:ss[.ssssss]
 Optional:      endtime=yyyy-mm-ddThh:mm:ss[.ssssss]
 Optional:      N S L C
 Optional:      N S L C starttime endtime

All rules for parameters apply equally whether specified using the GET or POST methods with the exception of 
blank location IDs, which must be specified as "--" in the POST body due to spaces being used as 
the field separator.

Below is a full list of service parameters and their usage.
Query: /ncedcws/beta-eventdata/1/query?[query-parameters]
where query-parameters:
eventid="eventid" RequiredSpecifies the event identifier.
catalog="catalog" OptionalSpecifies the catalog for the eventid (Default: NCSS).
network="network" OptionalSpecify SEED network code, example network=BK. Wildcards and comma separated list are accepted.
station="station" OptionalSpecify SEED station code, example station=CMB. Wildcards and comma separated list are accepted.
channel="channel" OptionalSpecify SEED channel code mask, example: channel=BHE. Wildcards and comma separated list are accepted.
location="location" OptionalSpecify SEED location code mask, example: location=00. substitute dash characters for white space, example: location=--. Wildcards and comma separated list are accepted.
starttime=YYYY-MM-DDThh:mm:ss[.sss] OptionalSpecifies the start-time for the miniSEED data.
endtime=YYYY-MM-DDThh:mm:ss[.sss] OptionalSpecifies the end-time for the miniSEED data.
nodata=204/404 Optional Specify which HTML status code is returned when no data is found (Default is 204).
URL Builder
Event
Data Channels
Time
URL: /ncedcws/beta-eventdata/1/query?


POST Submission Form


WADL

Retrieve the WADL associated with this service: application.wadl



Version: Eventdata Service:1.0.0