Reference · built on requestCommons signalEarth, seismic & volcanic

INGV FDSNWS Event

Italian earthquake locations and magnitudes from the INGV ISIDe catalogue over the fdsnws-event service.

About

The Istituto Nazionale di Geofisica e Vulcanologia publishes its earthquake catalogue, ISIDe, through an fdsnws-event service at webservices.ingv.it. The service returns QuakeML by default or a text table, and lists five catalogues: INGV, INGV-OV, INGV-OE, INGV-BULLETIN, and INGV-TDMT. Requests are rate-limited per IP address, with the allowance and reset time returned in response headers. INGV adds minradiuskm and maxradiuskm to the FDSN parameters so you can search by distance in kilometres.

Through Fibric, an operator pulls new and revised events with updatedafter, matches them to your Italian sites by radius in kilometres, and proposes an inspection, a lone-worker check, or an annotation for your approval.

This is a reference listing. It documents what Fibric would read from INGV FDSNWS Event and what it could propose, based on the publisher's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • Earthquakes from /fdsnws/event/1/query, filtered by starttime, endtime, depth, and magnitude
  • Events inside a rectangle with minlat, maxlat, minlon, maxlon, or around a point with lat, lon, and maxradiuskm
  • Events revised since your last read through updatedafter, which INGV describes as useful for synchronising events
  • One event by its INGV eventid, with includeallorigins, includeallmagnitudes, and includearrivals
  • Catalogue and contributor lists from /catalogs and /contributors, including INGV-ONT, INGV-OV, and INGV-OE
  • Results ordered by time or magnitude, ascending or descending, and paged with limit and offset

Proposed actions

Read-only. This feed informs operators; it changes nothing.

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Queue a building inspection after a nearby quake

    When an event above your magnitude threshold falls within maxradiuskm of a property, the operator drafts an inspection request with the INGV eventid for your approval.

    With Inspection Scheduling

  • Check on lone workers in the shaken area

    The operator matches the event to workers who are alone on site and proposes a welfare check, listing each worker and the event's time and magnitude.

    With Lone Worker

  • Separate quake-driven alarms from real faults

    When plant alarms flood within minutes of an INGV event, the operator groups them under the event and proposes one review instead of many tickets.

    With Alarm Flood

Requirements

  • Site coordinates in WGS84 and a radius in kilometres for the maxradiuskm filter
  • A client that reads X-RateLimit-Reset and backs off on a 429 response
  • A store of the last updatedafter timestamp per site, so you fetch only new and revised events
  • Attribution under CC BY 4.0 in anything you publish from the catalogue
Authentication
No key or account. The service is open over HTTPS and enforces a per-IP rate limit reported in the X-RateLimit-Limit and X-RateLimit-Reset headers.

Limits

  • The per-IP rate limit is enforced with 429 Too Many Requests; the numeric allowance is only given in the response headers
  • The format parameter accepts only xml and text; there is no JSON or GeoJSON output
  • The minradiuskm and maxradiuskm parameters are INGV extensions and do not exist on other FDSN event services
  • A 503 response carries a Retry-After header; do not retry before it elapses

Access and pricing

Reference listing. Public feed access is separate from Fibric integration. If you request this feed, your quote covers the build, usage, and support.

Request INGV FDSNWS Event ↗

Questions and answers

How does the INGV service tell you its rate limit?
Every response carries X-RateLimit-Limit, the number of requests allowed in the current period, and X-RateLimit-Reset, the seconds left in that period. The limit is applied per IP address. Exceeding it returns 429 Too Many Requests.
Which catalogues does the service expose?
The /catalogs endpoint lists INGV, INGV-OV, INGV-OE, INGV-BULLETIN, and INGV-TDMT. The /contributors endpoint lists INGV, INGV-ONT, INGV-OV, and INGV-OE. The data comes from the ISIDe catalogue.
How do you search by distance in kilometres?
Pass lat and lon with maxradiuskm, and optionally minradiuskm. INGV documents these as its own extension to the FDSN specification; the standard minradius and maxradius take degrees.
Ask about INGV FDSNWS Event

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.