Homepage

ASMI
 
Italian Archive of Historical Earthquake Data
 Web services homepage

Bibliography web service

By using this web service, it is possible to retrieve bibliographical metadata of ASMI data sources.
The service is currently under development, please use with care.

Specific publication ID request

Parameter Default Description
biblioid Type: text

Note. If you know the data source identifier, you may retrieve it directly by entering
https://emidius.mi.ingv.it/services/bibliography/query?biblioid=XXXXXXXX
Alternatively, you may enter
https://emidius.mi.ingv.it/services/bibliography/id/XXXXXXXX
Where "XXXXXXXX" is the bibliographic code identifier as used in the ASMI archive.

Examples:

https://emidius.mi.ingv.it/services/bibliography/query?biblioid=ALBRV010&format=xml_oai

https://emidius.mi.ingv.it/services/bibliography/query?biblioid=ALBRV010&format=xml_dc

https://emidius.mi.ingv.it/services/bibliography/query?biblioid=ALBRV010&format=rdf

https://emidius.mi.ingv.it/services/bibliography/query?biblioid=ALBRV010&format=bib

https://emidius.mi.ingv.it/services/bibliography/query?biblioid=ALBRV010&format=json

Are equivalent to:

https://emidius.mi.ingv.it/services/bibliography/id/ALBRV010?format=xml_oai

https://emidius.mi.ingv.it/services/bibliography/id/ALBRV010?format=xml_dc

https://emidius.mi.ingv.it/services/bibliography/id/ALBRV010?format=rdf

https://emidius.mi.ingv.it/services/bibliography/id/ALBRV010?format=bib

https://emidius.mi.ingv.it/services/bibliography/id/ALBRV010?format=json

Publications related to a specific earthquake

Parameter Default Description
eventid Type: text

Examples:

https://emidius.mi.ingv.it/services/bibliography/query?eventid=18800704_0820_000&format=xml_oai

https://emidius.mi.ingv.it/services/bibliography/query?eventid=18800704_0820_000&format=xml_dc

https://emidius.mi.ingv.it/services/bibliography/query?eventid=18800704_0820_000&format=rdf

https://emidius.mi.ingv.it/services/bibliography/query?eventid=18800704_0820_000&format=bib

https://emidius.mi.ingv.it/services/bibliography/query?eventid=18800704_0820_000&format=json

Bibliographic metadata

Parameter Default Description
author Type: text

Request publications by a specific author surname.

authorsearchmethod Type: text
Allowed values: exact, startwith, endwith, contains

Specify the method for searching a author.

title Type: text

Request publications having a specific title.

titlesearchmethod Type: text
Allowed values: exact, startwith, endwith, contains

Specify the method for searching a title.

journal Type: text

Request papers published in a specific journal.

journalsearchmethod Type: text
Allowed values: exact, startwith, endwith, contains

Specify the method for searching a journal.

publisher Type: text

Request studies by a specific publisher.

publishersearchmethod Type: text
Allowed values: exact, startwith, endwith, contains

Specify the method for searching a publisher.

Examples:

https://emidius.mi.ingv.it/services/bibliography/query?author=albini

https://emidius.mi.ingv.it/services/bibliography/query?title=catalog

https://emidius.mi.ingv.it/services/bibliography/query?journal=journal of seismology

https://emidius.mi.ingv.it/services/bibliography/query?publisher=springer

Year of publication

Parameter Default Description
year Type: integer
Unit: year

Limit to publications published in a specific year.

yearstart Type: integer
Unit: year

Limit to publications published on or after the specified start year.

yearend Type: integer
Unit: year

Limit to publications published on or before the specified end year.

Geographic constraints

Box area constraints (in alternative to Circle 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.

Example
https://emidius.mi.ingv.it/services/bibliography/query?minlat=44.559&maxlat=47.354&minlon=11.942&maxlon=14.513

Circle 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.

minradiuskm 0 Type: float
Unit: km

Limit to events within the specified minimum number of kilometers from the geographic point defined by the latitude and longitude parameters.

maxradiuskm 1 Type: float
Unit: km
Allowed values: between 1 and 500

Limit to events within the specified maximum number of kilometers from the geographic point defined by the latitude and longitude parameters.

Example
https://emidius.mi.ingv.it/services/bibliography/query?lat=46.523&lon=13.714&maxradiuskm=50

Output data structure

Parameter Default Description
format xml_dc Type: text
Allowed values: xml_oai, xml_dc, rdf, bib, text, textshort, json

Specify the format of result, either ‘xml’ (default) or ‘xml_complete’.
The xml format is encoded using a custom scheme, highly inspired by the macroseismic extension of QuakeML 2.0.
The ‘xml_complete’ format includes all administrative divisions stored in the Gazetteer.
The text format will output a complete biliographic citation.
The textshort format will output the short citation.
The json format will output the most relevant metadata encoded in JSON.

orderby year Type: text
Allowed values: author, year, title

Order the result by place or identifier, using the following possibilities:
author: order by the first author surname
year: order by year of publication
title: order by title of the publication

nodata 204 Type: boolean
Allowable values: 204, 404

Select status code for “no data”, either ‘204’ or ‘404’.