Eventdata Web Service
Home »
NCEDC Web Services » Eventdata
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/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/eventdata/1/query?[query-parameters] | ||
where query-parameters: | ||
eventid="eventid" | Required | Specifies the event identifier. |
catalog="catalog" | Optional | Specifies the catalog for the eventid (Default: NCSS). |
network="network" | Optional | Specify SEED network code, example network=BK. Wildcards and comma separated list are accepted. |
station="station" | Optional | Specify SEED station code, example station=CMB. Wildcards and comma separated list are accepted. |
channel="channel" | Optional | Specify SEED channel code mask, example: channel=BHE. Wildcards and comma separated list are accepted. |
location="location" | Optional | Specify 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] | Optional | Specifies the start-time for the miniSEED data. |
endtime=YYYY-MM-DDThh:mm:ss[.sss] | Optional | Specifies 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). |
POST Submission Form | |
Version: Eventdata Service:1.0.0