NasaApod
A Ruby gem for consuming the NASA Astronomy Picture of the Day API.
Installation
Add this line to your application's Gemfile:
gem 'nasa_apod'
And then execute:
$ bundle
Or install it yourself as:
$ gem install nasa_apod
Usage
Search by date:
client = NasaApod::Client.new(api_key: "DEMO_KEY") #DEMO_KEY usage is limited.
result = client.search(date: "2015-06-18") #You can also pass in a Ruby Date object.
result
Get title:
result = client.search
result.title #=> "M64: The Black Eye Galaxy"
Get explanation:
result = client.search
result.explanation #=> "This big, bright, beautiful spiral galaxy is Messier 64..."
Get image URL:
result = client.search
result.url #=> "http://apod.nasa.gov/apod/image/1506/CeresMountain_Dawn_1041.jpg"
Note: Sometimes result.url will return a video url. You should build logic to handle both media_type: 'image' and media_type: 'video'.
If the media_type: 'video', you can use thumbnail_url to get a jpg thumbnail of the video.
result = client.search
result.thumbnail_url #=> 'http://img.youtube.com/vi/3LdZ_NftIh8/sddefault.jpg'
Get HD image URL:
result = client.search(hd: true)
result.hd_url #=> "http://apod.nasa.gov/apod/image/1506/CeresMountain_Dawn_1041.jpg"
Random post:
result = client.wormhole
result
Contributing
- Fork it ( https://github.com/[my-github-username]/nasa_apod/fork )
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request