Macroseismic data stored in ASMI can be retrieved using this custom web service, which is highly inspired by the fdsnws-event web service.
The main difference between the fdsnws-event and this web service, is that the provided xml is encoded using QuakeML 2.0 experimental macroseismic package (v0.9).
In order to deal with macroseismic data, a series of additional query parameters are provided.
This experimental web service only provides macroseismic data directly managed by INGV.
If you know the event identifier, you may retrieve it directly by entering
https://emidius.mi.ingv.it/services/macroseismic/query?eventid=xxx
Alternatively, you may enter
https://emidius.mi.ingv.it/services/macroseismic/id/xxxx
Where "xxxx" is the event identifier.
Index
*** WARNINGS ***
Both the service and the QuakeML macroseismic extension are at an early stage of development.
In particular the macroseismic extension to the QuakeML schema
might change without prior notice, therefore is not yet suitable for production use. Here a quick and dirty overview of the current extension.
Please, contact mario.locati@ingv.it for further information.
Data provided by mean of this web service should not be used as input for any scientific purpose, data is not checked, might change withour prior notice, and it is only provided for testing the upcoming QuakeML macroseismic extension.
By default the number of earthquakes provided by each query is limited to 100 events. You may obtain more earthquakes by altering the default "limit" value.
Before downloading data you should carefully read the ASMI copyright notice, and the disclaimer.
In any case, if you use these data to produce anything that will be made public, you should reference data as downloaded from ASMI, citing also the original author of the data set.
*** NEWS about the upcoming QuakeML 2.0 Macroseismic package ***
The QuakeML v2.0 is currently under development.
Please check the current status on the QuakeML website.
Here you can see the current status of the Macroseismic package (13 April 2017), together with the Basic Event Description package, the Common package, and the Resource Metadata package.
Symbology
If you would like to plot macroseismic intensity data using the ASMI symbology, please have a look at the following link
AHEAD Macroseismic Intensity symbols color codes
Specific event ID request
Parameter | Default | Description |
---|---|---|
eventid |
Type: text, 17 characters
Select a specific event by enetering the event identifier. Event identifier structure (the number is the char position):
|
Example:
https://emidius.mi.ingv.it/services/macroseismic/query?eventid=13480125_1530_000
Time constraints
Parameter | Default | Description |
---|---|---|
starttime (abbrev. start) |
Type: text Unit: date and time * Allowed values: between year 1000 and 1899-12-31T23:59 Limit to events on or after the specified start time. |
|
endtime (abbrev. end) |
Type: text Unit: date and time * Allowed values: between year 1000 and 1899-12-31T23:59 Limit to events on or before the specified end time. |
|
updatedafter |
Type: text Unit: date and time * Allowable values: greater than 2013-12-31
Limit to events updated in ASMI after the specified time. |
* Date and time can be written in one of the followinf formats
- YYYY-MM-DDThh:mm
- YYYY-MM-DDThh
- YYYY-MM-DD
- YYYY-MM
- YYYY
Where
- YYYY, the year, always four-digits (1000-1899)
- MM, the month, always two-digits (01-12)
- DD, the day, always two-digits (01-31)
- T, date-time separator, you must use it if you enter the time
- hh, the hour, always two digits (00-23, AM/PM not allowed)
- mm, the minute, always two digits (00-59)
Notes
- if start is later than end, the system will be fault tolerant and will fix the error;
- due to the historical nature of data contained in ASMI, seconds are ignored
Example
https://emidius.mi.ingv.it/services/macroseismic/query?starttime=1742&endtime=1743-02-20
or using abbreviated parameters:
https://emidius.mi.ingv.it/services/macroseismic/query?start=1742&end=1743-02-20
Geographic constraints
Box area constraints (in alternative to Circular constraints)
Parameter | Default | Description |
---|---|---|
minlatitude (abbrev. minlat) |
-90 |
Type: float Unit: decimal degrees Allowed values: between -90 and 90 Limit to events with a latitude larger than or equal to the specified minimum. |
maxlatitude (abbrev. maxlat) |
90 |
Type: float Unit: decimal degrees Allowed values: between -90 and 90 Limit to events with a latitude smaller than or equal to the specified maximum. |
minlongitude (abbrev. minlon) |
-180 |
Type: float Unit: decimal degrees Allowed values: between -180 and 180 Limit to events with a longitude larger than or equal to the specified minimum. |
maxlongitude (abbrev. maxlon) |
180 |
Type: float Unit: decimal degrees Allowed values: between -180 and 180 Limit to events with a longitude smaller than or equal to the specified maximum. |
Circular constraints (in alternative to Box area constraints)
Parameter | Default | Description |
---|---|---|
latitude (abbrev. lat) |
0 |
Type: float Unit: decimal degrees Allowed values: between -90 and 90 Specify the latitude to be used for a radius search. |
longitude (abbrev. lon) |
0 |
Type: float Unit: decimal degrees Allowed values: between -180 and 180 Specify the longitude to the used for a radius search. |
minradius | 0 |
Type: float Unit: geographical degrees Limit to events within the specified minimum number of degrees from the geographic point defined by the latitude and longitude parameters. |
maxradius | 1 |
Type: float Unit: geographical degrees Allowed values: between 1 and 5 Limit to events within the specified maximum number of degrees from the geographic point defined by the latitude and longitude parameters. |
mindepth |
Type: float Unit: km Limit to events with depth more than the specified minimum. |
|
maxdepth |
Type: float Unit: km Limit to events with depth less than the specified maximum. |
Example
https://emidius.mi.ingv.it/services/macroseismic/query?lat=45.956&lon=13.227&maxradius=100&limit=300
Magnitude constraints
Parameter | Default | Description |
---|---|---|
minmagnitude (abbrev. minmag) |
Type: float Unit: magnitude Limit to events with a magnitude larger than the specified minimum. |
|
maxmagnitude (abbrev. maxmag) |
Type: float Unit: magnitude Limit to events with a magnitude smaller than the specified maximum. |
|
magnitudetype (abbrev. magtype) |
Type: text Allowed values: ML, Ms, mb, Mw, nd
Specify a magnitude type to use for testing the minimum and maximum limits. |
Example:
https://emidius.mi.ingv.it/services/macroseismic/query?minmag=5.6&maxmag=5.9
Data source constraints
Parameter | Default | Description |
---|---|---|
catalog |
Type: text Allowed values: Limit to events from a specified catalog. |
|
contributor |
Type: text Allowed values: Limit to events contributed by a specified contributor. |
Output data structure
Parameter | Default | Description |
---|---|---|
format | xml |
Type: text Allowed values: xml, text, textmacro
Specify format of result, either ‘xml’ (default) or ‘text’. |
orderby | time |
Type: text Allowed values: time, time-asc, magnitude, magnitude-asc
Order the result by time or magnitude with the following possibilities: |
includeallorigins | false |
Type: boolean Allowed values: true/false (case insensitive) Specify if all origins for the event should be included. By default only the preferred origin only is included.. |
includeallmagnitudes | false |
Type: boolean Allowed values: true/false (case insensitive) Specify if all magnitudes for the event should be included. By default only the preferred magnitude only is included. |
limit | 100 |
Type: integer Allowed values: between 1 and 5000 Limit the results to the specified number of events. |
offset | 1 |
Type: integer Allowable values: Return results starting at the event count specified, starting at 1. |
nodata | 204 |
Type: boolean Allowable values: 204, 404 Select status code for “no data”, either ‘204’ or ‘404’. |
Non standard FDSN-event parameters
Parameter | Default | Description |
---|---|---|
minradiuskm | 0 |
Type: float Unit: km Limit to events within the specified minimum number of kilometers (km) from the geographic point defined by the latitude and longitude parameters. |
maxradiuskm | 50 |
Type: float Unit: km Allowed values: between 1 and 500 Limit to events within the specified maximum number of kilometers (km) from the geographic point defined by the latitude and longitude parameters. |
contributorid | false |
Type: text Allowed values: true/false (case insensitive)
Request the event identifier provided by a contributor. |
macroseismicpackage | true |
Type: boolean Allowed values: true/false (case insensitive)
Specify if the QuakeML 2.0 Macroseismic Package should be turned on. |
includeallmdpsets | false |
Type: boolean Allowed values: true/false (case insensitive)
Specify if all available MDPsets associated to the earthquakes should be included. |
includemdps | false |
Type: boolean Allowed values: true/false (case insensitive)
Specify if MDPs contained in each MDP set should be included. |
mdpsetid | false |
Type: integer Allowed values: true/false (case insensitive) Select a specific event by entering its event identifier. |
minmdps | false |
Type: integer Allowed values: no limit Limit to events with a minimum number of MDPs larger or equal to the specified minimum. |
maxmdps | false |
Type: integer Allowed values: no limit Limit to events with a maximum number of MDPs lower or equal to the specified maximum. |
minintensity | false |
Type: text Allowed values:
Limit to events with a maximum reported intensity larger or equal to the specified minimum. |
maxintensity | false |
Type: text Allowed values:
Limit to events with a maximum reported intensity lower or equal to the specified maximum. |
Not supported fdsnws-event parameters
Parameter | Default | Description |
---|---|---|
includearrivals |
Type: boolean Allowed values: true/false (case insensitive) Specify if phase arrivals should be included. |