Consumes the USNO's imagery data services

View the Project on GitHub rthbound/usno-imagery

USNO::Imagery Code ClimateCoverage StatusBuild Status

Builds URLs for consuming USNO's imagery data services. These services provide synthetic views of earth and other selected solar system bodies, e.g.

For example, here's a few of earth right now. (USNO warns generating new images may take 10-15 seconds)

Earth as seen from the Sun

Earth as seen from our Moon


Add this line to your application's Gemfile:

gem 'usno-imagery'

And then execute:

$ bundle

Or install it yourself as:

$ gem install usno-imagery



The earth namespace will contain classes for viewing USNO's earth images.

# Mercator projection showing day / night (at any given time)
  #=> ""

# A spherical view of Earth as seen from the sun (at any given time)
  #=> ""

# A spherical view of Earth as seen from the moon (at any given time)
  #=> ""

# Earth at sunrise
  #=> ""

# Earth at sunset
  #=> ""

Other celestial bodies

Synthetic views of all celestial bodies can be fetched for any time between 1700 & 2100 A.D.

# Our Moon
  #=> ""

# Mercury
  #=> ""

# Venus
  #=> ""

# For a radar image of Venus, radar: true)
  #=> ""

# Mars
  #=> ""

# Jupiter
  #=> ""

# Jupiter's moon Io
  #=> ""

# Jupiter's moon Europa
  #=> ""

# Jupiter's moon Ganymede
  #=> ""

# Jupiter's moon Callisto
  #=> ""

Other USNO libraries

usno-transit provides times of rise, set, and transit for major solar system bodies and selected bright stars. The output table also includes azimuth at rise and set as well as altitude at transit.


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Bitdeli Badge