PyQuakes is a Python wrapper for USGS Earthquake Catalog API that manages data querying and result processing. PyEarthquake also integrates Bing Map API to manage geolocation of events.
- Handles the HTTP requests, and the HTTP error. Only needs to focus on setting parameters and data processing.
- Supports setting the query parameters
- Supports searching with multiple time periods with easy-to-understand time format.
- Supports searching with multiple locations with pre-defined location classes.
- Provides geocoding functionality so that users are able to search the location without finding the coordinates.
- Supports filtering, sorting and organizing the result.
Follow the instructions of Bing Map to get your own key and copy your Bing Map Key in key.txt file under src foler.
The EarthquakeQuery class has to be imported to use the API.
Import other classes if you would like to search by time and location or set other parameters.
To use geocode API, please specify the path of the key file first:
EarthquakeQuery.set_geocode_key_path("filepath")
A typical usage to search a collection of results is:
from pyquakes import GeoRectangle, EarthquakeQuery, TimeFrame
import datetime
query = EarthquakeQuery()
query.set_time([TimeFrame(datetime(2010, 1, 1), datetime(2015, 1, 1))])
query.set_max_depth(1.0)
result = query.search()
A typical usage to search a specific earthquake by its event id is:
from pyquakes import EarthquakeQuery
event_id = "usc000lvb5"
result = EarthquakeQuery.search_by_event_id(event_id)
For more examples, please refer to the client folder. Several use cases are contained in the clinet folder with example codes. See the function without original suffix.