[webservices] A new release of the DMC's ws-event service (1.3.3)

Yazan Suleiman yazan at iris.washington.edu
Wed Sep 12 11:06:09 PDT 2012


Hello web services users,

The DMC has released a new version of ws-event (1.2.3).  This version include all changes in the 1.2.2 beta release.

http://www.iris.edu/ws/event/
http://www.iris.edu/ws/doc/event_help.htm

This release is backwards compatible with the current production release with one notable behavior change: by default only the primary magnitude is returned for each event.  Previously all magnitudes were returned for each event by default.

Other changes include new text output format, useful for rapid access to simple event parameters where full details and XML would be burdensome, e.g. a web interface or simple data extraction script.  The text format contains key event parameters separated by vertical bar characters (|).

The designation of a primary magnitude per event is now included.  Also added is new 'offset' parameter that, when combined with the 'limit' parameter, allows for sub-setting the results.

In the near future the DMC will update the IRIS-WS Java library to match the new parameter names.  The current version will continue to work.

The DMC's FetchEvent script has been updated to match the service, minor changes only.  The current version will continue to work but users are encouraged to update:  http://www.iris.edu/ws/wsclients/

regards,
Web services team


Detailed descriptions of the changes are below and posted here:

http://www.iris.edu/ws/doc/event_revisions.htm

* New includeallorigins parameter replaces the now deprecated preferredonly parameter. By default, includeallorigins is "no" and only the primary origin is returned.

* The default for the includeallmagnitudes parameter is now "no" and only the primary magnitude is returned. Also, includeallmagnitudes now refers to all magnitudes for an event and not just those associated with the primary origin. 

* New output parameter and output format supported:
output=xml - Results are returned in XML (QuakeML) format, this is the default
output=text - Results are returned in a simple text format
Important: The text output is only supported for primary origins and magnitudes. This output format is designed for use with web mapping or other simple event list applications.

* New offset parameter controls the starting event when returning result sets, default is 1 (the first event). When used in combination with the limit parameter this can be used to subset result sets.

* QuakeML results include preferredMagnitudeID tag to identify the primary magnitude.

* QuakeML results include originID tag for magnitude information to identify the origin-magnitude association.

* A WADL is available to list the interface parameters: http://www.iris.edu/wsbeta/event/application.wadl

Bug fixes since the 1.2.2 release:
* Added new HTTP Header "Access-Control-Allow-Origin: *".
* Fixed a bug dealing with duplicate events.
* Fixed a bug related to the limit parameter.
* Input parameter names are now case insensitive.




More information about the webservices mailing list