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):
|
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. |
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
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’. |
| orderby |
Type: text Allowed values: name, identifier
Order the result by place or identifier, using the following possibilities: |
|
| 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’. |