Description

The Dataselect webservice gives access to multiple channels of FDSN miniSEED data for specified time ranges.

Query Usage

HTTP GET

            /(query|queryauth)? (channel-options) (time-range-options) [quality-options] [length-options]
            where
              channel-options	 :: (network=<NET[,NET,...]>) (station=<STA[,STA,...]>) (location=<LOC[,LOC,...]>) (channel=<CHA[,CHA,...]>)
              time-range-options :: (starttime=<time>) (endtime=<time>)
              quality-options	 :: [quality=<quality-indicator>]
              length-options     :: [minimumlength=<seconds>] [longestonly=<true|false>]

            (..) required
            [..] optional

            HTTP GET query parameters are joined by ampersands "&", without blank space (see the sample queries).

HTTP POST

            /(query|queryauth)

            Post Body:
              ------------------------------------
              [quality=<quality-indicator>]
              [minimumlength=<seconds>]
              [longestonly=<true|false>]	
              NET STA LOC CHA STARTTIME ENDTIME
              NET STA LOC CHA STARTTIME ENDTIME
              ...
              ------------------------------------

            (..) required
            [..] optional

        

Sample Queries

note : you may click those links from your browser, or find it useful to request our webservices via a command line program such as wget. Example :

wget "http://ws.resif.fr/fdsnws/dataselect/1/query?network=FR&station=RUSF&starttime=2010-01-10T05:00:00&endtime=2010-01-10T07:00:00" -O outputfile

Detailed Descriptions of HTTP GET Query Parameter

Parameter/
Abbr.
ExamplesDiscussion

Channel Options

These required options allow you to specify which channel(s) of data to retrieve

  • ex: ...network=IU&station=ANMO&location=00&channel=BH1...
  • ex: ...net=IU&sta=ANMO&loc=00&cha=BH1...
  • ex: ...network=IU&station=ANMO,QSPA&location=00,10&channel=BH1,BH2...
network
net
IU  IU,IM Required
Network code. Comma separated lists are accepted.
station
sta
ANMO  ANMO,QSPA Required
One to five character channel code. Comma separated lists are accepted.
location
loc
00  00,10 Required
Two letter location code. Comma separated lists are accepted. Use '--' for empty codes.
channel
cha
BHZ  BHZ,BH1,BH2 Required
Three letter network code. Comma separated lists are accepted.

Time Range Options

A time range is required. Times are UTC

  • ex: ...starttime=2010-02-27T06:30:00&endtime=2010-02-27T10:30:00... (retrieve data from 2010 Feb 27 06:30:00 to 2010 Feb 27 10:30:00)
  • ex: ...start=2010-02-27T06:30:00.000&end=2010-02-27T10:30:00.000... (same as previous)
  • ex: ...starttime=2010-02-27T00:00:00.000000&endtime=2010-02-27T24:59:59.999999... (all data for the day 2010 Feb 27)
starttime
start
2010-02-27T06:30:00.123 Required
Specifies the start-time for the miniSEED data
endtime
end
2010-02-27T10:30:00.456 Required
Specifies the end-time for the miniSEED data

Additional Options

both quality and minimumlength are optional

quality D Optional
One character letter. Represents the miniSEED "Fixed Section of Data Header" Data header/quality indicator.
minimumlength 86400.0 Optional
Enforce minimum segment length (seconds), default is to return all segments.
Only time-series segments of this length or longer will be returned.
Note: No data will be returned for selected time windows shorter than minimumlength.
longestonly true Optional
Limit to longest segment only, default is false (return all segments).
For each time-series selection, only the longest segment is returned.
"true" and "false" can be used with this option.

Detailed Descriptions of HTTP POST Query Parameter

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 applcation/x-www-form-urlencoded or mutlipart/form-data.

The quality, minimumlength and longestonly parameters should be specified as key=value pairs on separate lines and the simple time and channel constraints parameters repeated as many times as necessary following this pattern:

     quality=Q
     minimumlength=300.0
     longestonly=FALSE	
     NET STA LOC CHA STARTTIME ENDTIME
     NET STA LOC CHA STARTTIME ENDTIME
     NET STA LOC CHA 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 filed separator.

Time Formats

YYYY-MM-DDThh:mm:ss[.ssssss] ex. 1997-01-31T12:04:32.123

Where:

    YYYY    :: four-digit year
    MM      :: two-digit month (01=January, etc.)
    DD      :: two-digit day of month (01 through 31)
    T       :: date-time separator
    hh      :: two digits of hour (00 through 23) (AM/PM NOT allowed)
    mm      :: two digits of minute (00 through 59)
    ss      :: two digits of second (00 through 59)
    ssssss  :: one to six digits representing decimal fractions of a second, down to microseconds   

WADL

Retrieve the WADL associated with this service:

application.wadl


	Version: 1.1.0