Web Service - Events
A web service to retrieve event information in either SeisComP XML (similar to QuakeML) or as plain summary (row based) can be found here. Alternatively an event browser is available.
The gzip flag can be used to transfer the content compressed with gzip which is done automatically if the client reports (x-)gzip support through Accept-Encoding (not yet for txt format).
Parameter | Type | Description |
---|---|---|
Events | ||
include | list | Specify whether to include pick/arrival/magnitude information or not. Valid values are: all, picks, arrs, amps, stamags, nonpref. Default is an empty list which retrieves only the preferred magnitude and origin without arrivals. |
Event attributes | ||
id | string | Specify the event id, example id=gfz2011ocqa. If id is not given the result is plain text table where each row represents an event. Row format: timestamp;otime;mag;mag_t;lat;lon;depth;phases;agency;status;type;region |
minmag | float | Specify the minimum magnitude. |
maxmag | float | Specify the maximum magnitude. |
mag_t | string | Type of event magnitude. |
mindepth | float | Specify the minimum depth. |
maxdepth | float | Specify the maximum depth. |
Rectangular bounding area | ||
minlat | degrees | Specify minimum latitude, southern boundary [-90 <= X <= 90]. |
maxlat | degrees | Specify maximum latitude, northern boundary [-90 <= X <= 90]. |
minlon | degrees | Specify minimum longitude , western boundary [-180 <= X <= 180]. |
maxlon | degrees | Specify maximum longitude , eastern boundary [-180 <= X <= 180]. |
minphases | count | Specify minimum phases used in origin solution. |
maxphases | count | Specify maximum phases used in origin solution. |
Time queries | ||
start | date | Select events with origin time after this date, format = %Y-%m-%d[T%H:%M:%S]. |
end | date | Select events with origin time before this date, format = %Y-%m-%d[T%H:%M:%S]. |
updatedbefore | date | Select events updated before this date, format = %Y-%m-%d[T%H:%M:%S]. |
updatedafter | date | Select events updated after this date, format = %Y-%m-%d[T%H:%M:%S]. |
Miscellaneous attributes | ||
agency | string | Agency creating the origin. |
status | string | Evaluation status of the origin. |
type | string | Event type, e.g. 'earthquake', 'not existing'. |
region | string | Event region. |
Options | ||
sort | string | Result set order. Use time for ascending and -time for descending origin time order. |
limit | integer | Limits the result set. A value > 0 is required. |
offset | integer | Offset within the resultset. '0' denotes the first item. |
gzip | Force gzip compression. | |
download | Adds the filename {eventid}.xml[.gz] to the HTTP response header. The browsers accepted encoding is then ignored and the result is only compressed if the gzip flag is passed as well. |