EIDAWS Routing Webservice Specification

The EIDA routing service is the webservice that routes requests for different services between EIDA nodes. Different networks will be routed to different data centers depending on their respective data holdings.


eidaws/routing/1/query

This service is an implementation of the EIDA web service specification version 1. For a complete service description refer to the routing specification document.


Making a GET request

Routing information can be extracted from the routing webservices by contacting the webservice address with specific request options inside the URL query. Webservice requests are generally formatted as follows:

http://webservice-address/label?options

Example! Copy the following URL

http://www.orfeus-eu.org/eidaws/routing/1/query?network=GE&service=dataselect

This request will return EIDA routing information for network GE from ORFEUS Data Center. The response indicates that the dataselect service for network GE is located at GFZ and waveform data can be retrieved at the returned URL.


Routing Service Parameters

Parameter Examples Description Default Type
Temporal Constraints
starttime (start) 2016-01-01T00:00:00 Starttime of request ISO-8601
endtime (end) 2016-01-02T00:00:00 Endtime of request ISO-8601
SEED Identifiers
network (net) NL SEED Network code String
station (sta) HGN SEED Station code String
location (loc) 00, -- SEED Location code String
channel (cha) BHZ, HH* SEED Channel code String
Request Options
minlatitude (minlat) 20 Limit to stations with a latitude larger than or equal to the specified minimum. Float
maxlatitude (maxlat) 65 Limit to stations with a latitude smaller than or equal to the specified maximum. Float
minlongitude (minlon) -15 Limit to stations with a longitude larger than or equal to the specified minimum. Float
maxlongitude (maxlon) 70 Limit to stations with a longitude smaller than or equal to the specified maximum. Float
service dataselect Service (dataselect, station, wfcatalog) dataselect String
format json Response format (xml, json, get, post) xml String
alternative true Include alternative routes false Boolean

Wildcards and Lists

A question mark represents a single character, while an asterisk represents zero or more characters. Multiple items may also be retrieved using a comma separated list. SEED identifiers support wildcards and lists.

Time Formats

Times must be specified in the ISO-8601 format (e.g. 2017-01-01T00:00:00 or 2017-01-01) and are assumed to be in UTC


Simple user interface

A Swagger made User Interface is available for the EIDA Routing Webservice here.