Library for convenient access to the INGV Centro Nazionale Terremoti (Earthquakes) feed.
This library provides convenient access to the INGV Centro Nazionale Terremoti (Earthquakes) Feed.
pip install georss-ingv-centro-nazionale-terremoti-client
See below for an example of how this library can be used. After instantiating
the feed class and supplying the required parameters, you can call update
to
retrieve the feed data. The return value will be a tuple of a status code and
the actual data in the form of a list of specific feed entries.
Status Codes
Supported Filters
Filter | Description | |
---|---|---|
Radius | filter_radius |
Radius in kilometers around the home coordinates in which events from feed are included. |
Minimum Magnitude | filter_minimum_magnitude |
Minimum magnitude as float value. Only events with a magnitude equal or above this value are included. |
Example
from georss_ingv_centro_nazionale_terremoti_client import \
IngvCentroNazionaleTerremotiFeed
# Home Coordinates: Latitude: 40.84, Longitude: 14.25
# Filter radius: 200 km
# Filter minimum magnitude: 4.0
feed = IngvCentroNazionaleTerremotiFeed((40.84, 14.25),
filter_radius=200,
filter_minimum_magnitude=4.0)
status, entries = feed.update()
The Feed Manager helps managing feed updates over time, by notifying the consumer of the feed about new feed entries, updates and removed entries compared to the last feed update.
After a successful update from the feed, the feed manager will provide two different dates:
last_update
will be the timestamp of the last successful update from the
feed. This date may be useful if the consumer of this library wants to
treat intermittent errors from feed updates differently.last_timestamp
will be the latest timestamp extracted from the feed data.
This requires that the underlying feed data actually contains a suitable
date. This date may be useful if the consumer of this library wants to
process feed entries differently if they haven't actually been updated.