The event Web service provides access to contributed origin and magnitude estimates in QuakeML format. Events may be filtered e.g. by hypocenter, time and magnitude parameters. The request type is HTTP-GET only. Please refer to http://www.fdsn.org/webservice for a complete service description.
Group | Parameter | Abbrevation | Default | Minimum | Maximum | Type | Units | Description |
---|---|---|---|---|---|---|---|---|
time constraints | ||||||||
starttime | start | [Any] | [Any Valid Time] | time | UTC | Limit to events on or after the specified start time. | ||
endtime | end | [Any] | [Any Valid Time] | time | UTC | Limit to events on or before the specified end time. | ||
geographic constraints | ||||||||
minlatitude | minlat | -90.0 | -90.0 | 90.0 | float | degrees | Limit to events with a latitude larger than or equal to the specified minimum. | |
maxlatitude | maxlat | 90.0 | -90.0 | 90.0 | float | degrees | Limit to events with a latitude smaller than or equal to the specified maximum. | |
minlongitude | minlon | -180.0 | -180.0 | 180.0 | float | degrees | Limit to events with a longitude larger than or equal to the specified minimum. | |
maxlongitude | maxlon | 180.0 | -180.0 | 180.0 | float | degrees | Limit to events with a longitude smaller than or equal to the specified maximum. | |
output constraints | ||||||||
format | xml | One of: xml, text or json | string | [Not Applicable] | Specify format of result, either ‘xml’ (default), ‘text’ or ‘json’. If this parameter is not specified the service must return QuakeML. | |||
nodata | 204 | One of: 204 or 404 | string | [Not Applicable] | Select status code for “no data”, either ‘204’ (default) or ‘404’. | |||
service-specific constraints | ||||||||
mindepth | [Any] | [Any] | [Any] | float | kilometers | Limit to events with depth more than the specified minimum. | ||
maxdepth | [Any] | [Any] | [Any] | float | kilometers | Limit to events with depth less than the specified minimum. | ||
minmagnitude | minmag | [Any] | [Any] | [Any] | float | defined by the | Limit to events with a magnitude larger than the specified minimum. | |
maxmagnitude | maxmag | [Any] | [Any] | [Any] | float | mag type | Limit to events with a magnitude smaller than the specified minimum. | |
magnitudetype | magtype | [Any] | [Not Applicable] | string | [Not Applicable] | Specify a magnitude type to use for testing the minimum and maximum limits. | ||
includeallorigins | FALSE | [Not Applicable] | boolean | [Not Applicable] | Specify if all origins for the event should be included, default is data center dependent but is suggested to be the preferred origin only. | |||
includeallmagnitudes | FALSE | [Not Applicable] | boolean | [Not Applicable] | Specify if all magnitudes for the event should be included, default is data center dependent but is suggested to be the preferred magnitude only. | |||
includearrivals | FALSE | [Not Applicable] | boolean | [Not Applicable] | Specify if phase arrivals should be included. | |||
eventid | [Any] | [Not Applicable] | string | [Not Applicable] | Select a specific event by ID; event identifiers are data center specific. | |||
limit | [Any] | 1 | [Any Positive] | integer | [Not Applicable] | Limit the results to the specified number of events. | ||
offset | 1 | 1 | [Any Positive] | integer | [Not Applicable] | Return results starting at the event count specified, starting at 1. | ||
orderby | time | One of: time, time-asc, magnitude or magnitude-asc | string | [Not Applicable] | Order the result by time or magnitude with the following possibilities: time: order by origin descending time time-asc: order by origin ascending time magnitude: order by descending magnitude magnitude-asc: order by ascending magnitude |
|||
non-standard constraints | ||||||||
includefocalmechanism | FALSE | [Not Applicable] | boolean | [Not Applicable] | Include focal mechanism information when available (effective only for json output). | |||
includeshakemap | FALSE | [Not Applicable] | boolean | [Not Applicable] | Include shakemap information when available (effective only for json output). | |||
requirefocalmechanism | FALSE | [Not Applicable] | boolean | [Not Applicable] | Filter events to keep only those that have focal mechanism. | |||
requireshakemap | FALSE | [Not Applicable] | boolean | [Not Applicable] | Filter events to keep only those that have shakemap. | |||
eventtype | [ANY] | [Not Applicable] | string | [Not Applicable] | Filter events to keep only those that match the given event type. Multiple event types can be given separated by comma (','). The valid event types are listed below. If at least one given event type is not valid, the request return a 400 error code. |