AHEAD European Archive of Historical EArthquake Data

  Gazetteer web service  

> AHEAD Web services homepage

By using this web service, it is possible to retrieve information about inhabited places for which macroseismic data is available in AHEAD.
The service is currently under development and the queryable area is restricted to Italian places only.

If you know the place identifier, you may retrieve it directly by entering
https://www.emidius.eu/services/gazetteer/query?placeid=XXXXXXXX
Alternatively, you may enter
https://www.emidius.eu/services/gazetteer/id/XXXXXXXX
Where "XXXXXXXX" is the place identifier.

Specific place ID request

Parameter Default Description
placeid Type: text with 8 characters

Structure (the number is the char position):

  • 1-2 country code
  • 3 "_"
  • 4-8 identifier between 00001 and 99999

Example:
https://www.emidius.eu/services/places/query?placeid=IT_14353&format=xml_complete

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 places 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 places 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 places 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 places with a longitude smaller than or equal to the specified maximum.

Example
https://www.emidius.eu/services/gazetteer/query?minlat=44.559&maxlat=47.354&minlon=11.942&maxlon=14.513&limit=300

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 places 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 500

Limit to places 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 places 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 places within the specified maximum number of kilometers (km) from the geographic point defined by the latitude and longitude parameters.

Example
https://www.emidius.eu/services/places/query?lat=45.694&lon=9.671&maxradiuskm=10&format=xml_complete

Toponyms constraints

Parameter Default Description
name Type: text

Limit to places matching the entered name.

municipality Type: text

Limit to places falling into a specified municipality.

namesearchmethod Type: text
Allowed values: startwith, endwith, contains

Limit to places falling into a specified municipality.

Examples

https://www.emidius.eu/services/gazetteer/query?municipality=bergamo&format=xml_complete

https://www.emidius.eu/services/gazetteer/query?name=berg&namesearchmethod=startwith&format=xml_complete

Output data structure

Parameter Default Description
format xml Type: text
Allowed values: xml, xml_complete

Specify the format of result, either ‘xml’ (default) or ‘xml_complete’.
The xml format is encoded using a custom scheme, mostlu based on the macroseismic extension of QuakeML 2.0.
The ‘xml_complete’ format includes all administrative divisions stored in the Gazetteer.

orderby Type: text
Allowed values: name, identifier

Order the result by place or identifier, using the following possibilities:
place: order by place descending
place-asc: order by place ascending
identifier: order by descending identifier
identifier-asc: order by ascending identifier

limit 100 Type: integer
Allowed values: between 1 and 5000

Limit the results to the specified number of places.

offset 1 Type: integer
Allowable values:

Return results starting at the place count specified, starting at 1.

nodata 204 Type: boolean
Allowable values: 204, 404

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