Document Actions
Quake Web Services
GeoNet earthquake information and felt reports can be queried using a variety of web services.
URL Construction
All requests use the HTTP GET method and all request URLs start with the hostname and service name:
- http://app-beta.geonet.org.nz/services/quake/
Earthquake Queries
For retrieving individual events in QuakeML use the following URL followed by the earthquake reference number:
- http://app-beta.geonet.org.nz/services/quake/quakeml/1.0.1/ref/
For retrieving one or more events in QuakeML or KML (for display in Google Earth/Maps), use the following URLs respectively, followed by a set of search parameters:
- http://app-beta.geonet.org.nz/services/quake/quakeml/1.0.1/search?
- http://app-beta.geonet.org.nz/services/quake/kml/2.2/search?
Query parameters are:
- startDate and endDate (mandatory)
- latLower, latUpper, longLower and longUpper (optional, but if present, all must be specified)
- magnitudeLower and magnitudeUpper (optional, but if present, both must be specified)
- depthUpper and depthLower (optional, but if present, both must be specified)
- stationsLower, stationsUpper and errorUpper (optional, but if present, all must be specified)
- output=all (optional)
Note: Viewing large datasets in a web browser is not recommended, for example all earthquakes in one year. A web service client that streams the data to a file is a better option. Searches are restricted to a 1 year period for the default minimal output and further restricted to a 3 month period if output=all is specified.
Sample Individual Event Query
Earthquake information for the specified reference number 2737452:
http://app-beta.geonet.org.nz/services/quake/quakeml/1.0.1/ref/2737452
Sample Search Queries
Earthquakes that occurred between the dates 2007-05-17 and 2007-05-18 (inclusive). QuakeML output is a minimal dataset containing a single preferred origin and possibly multiple magnitudes:
KML: http://app-beta.geonet.org.nz/services/quake/kml/2.2/search?startDate=2007-05-17&endDate=2007-05-18
Earthquakes that occurred between the dates 2007-05-17 and 2007-05-19 inclusive, within the bounding box latLower=-45, latUpper=-40, longLower=173, longUpper=176 of magnitude up to 7.5 that occurred up to 180 km depth with at least 5 phases recorded and at least 5 stations and with a standard error maximum of 0.15 seconds:
Felt Report Queries
For retrieving one or more felt reports in GML (3.1.1 restricted to simple features profile 1.0.0), use the following URL followed by a set of parameters:
Only reports matched to a valid placename with an associated position (latitude and longitude) values are retrieved. Query parameters are:
Sample Individual Event Query
All felt reports for the earthquake with reference number 2737452 and agency g (always use agency g); both are mandatory for this query type:
http://app-beta.geonet.org.nz/services/quake/reports/search?externalRef=2737452&agency=g
Sample Date Queries
Felt reports submitted on and after yyyy-mm-dd up to the present day. Format is standard date format ISO-8601 format yyyy-mm-dd. Note: this link is deactivated in case it returns too much data; please use with care:
http://app-beta.geonet.org.nz/services/quake/reports/search?startDate=yyyy-mm-dd
Felt reports submitted between 2007-05-17 and 2007-05-18. Format is standard date format ISO-8601 format yyyy-mm-dd:
http://app-beta.geonet.org.nz/services/quake/reports/search?startDate=2007-05-17&endDate=2007-05-18
