Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A gem exposing the U.S. Geological Survey's real-time earthquake data
branch: master
Failed to load latest commit information.
lib uptick version and ship it
tests added epicenter as an acceptable criterion
.gitignore added rvmrc file
.rvmrc
Gemfile initial commit
LICENSE.md
README.md cosmetic changes on readme
Rakefile initial commit
quake.gemspec tweaked contents of gemspec

README.md

Quake

Quake is a library exposing the U.S. Geological Survey's real-time earthquake data. As described on USGS' Earthquake Hazards Program, "earthquake information is extracted from a merged catalog of earthquakes located by the USGS and contributing networks. Earthquakes will be broadcast within a few minutes for California events, and within 30-minutes for worldwide events".

Installation

via Gem:

[sudo|rvm] gem install quake

via Bundler:

gem "quake"

Basic Usage

Fetch all the earthquakes from the past week:

events = Quake::Event.last_week

Fetch all the earthquakes from the past day:

events = Quake::Event.last_day

Fetch all the earthquakes from the past hour:

events = Quake::Event.last_hour

Fetch all the earthquakes from the past [week|day|hour] with minimum and/or maximum magnitudes:

events = Quake::Event.last_week :min_magnitude => 3
events = Quake::Event.last_week :max_magnitude => 4
events = Quake::Event.last_week :min_magnitude => 3, :max_magnitude => 4

Fetch all the earthquakes from the past [week|day|hour] with a minimum and/or maximum magnitude at or near a location (in km):

events = Quake::Event.last_week :min_magnitude => 2, :epicenter => "37.156, -117.3723"
events = Quake::Event.last_week :min_magnitude => 2, :epicenter => "37.156, -117.3723", :distance => 100

Questions or Problems?

If you have any issues, please add them to GitHub or fork the project and send a pull request (with tests of course). The tests are very straight forward, nothing more than minitest; yay for simplicity!

Something went wrong with that request. Please try again.