Project

nasa_earth

0.0
No commit activity in last 3 years
No release in over 3 years
An unofficial NASA Earth API wrapper. It can be used to display images for a specific location at different period in time.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Runtime

~> 1.0
 Project Readme

NASA Earth

This is a wrapper for the NASA earth API.

This allows to retrieve pictures taken by the satellite Landsat 8 for any coordinates on Earth, and at any point in time!

Note : You will need to request an API key from NASA to use this gem.

Installation

Simply type :

gem install nasa_earth

Or add this line to your Gemfile :

gem 'nasa_earth'

Imagery endpoint

Retrieve an URL of an image at specific coordinates.

Example

require 'nasa_earth'
n = NasaEarth.new api_key: 'your_api_key'
n.imagery lat: 48.8583701, lon: 2.2944813

=> {"code"=>"200", "message"=>"OK", "content"=>{
    "date"=>"2015-08-26T10:40:37",
    "url"=>"https://earthengine.googleapis.com/api/thumb?thumbid=d29fb6c5e2259cc02a7634c3f63b1265&token=13516c99554e9196d4e4c50e5c171c92",
    "id"=>"LC8_L1T_TOA/LC81990262015238LGN00"}}

Parameters

Parameter Type Mandatory Description
lat Float Yes Latitude
lon Float Yes Longitude
dim Float No width and height in degrees
date String (format YYYY-MM-DD) No date of image
cloud_score Boolean No calculate the percentage of cloud

Assets endpoint

Retrieve different date-time for available imagery at specific coordinates

Example

require 'nasa_earth'
n = NasaEarth.new
n.api_key = 'your_api_key'
n.assets lon: 10.0, lat: 11

=> {"code"=>"200", "message"=>"OK", "content"=>{"count"=>46, "results"=>
  [{"date"=>"2013-05-12T09:38:57", "id"=>"LC8_L1T_TOA/LC81870522013132LGN01"},
   {"date"=>"2013-05-28T09:39:04", "id"=>"LC8_L1T_TOA/LC81870522013148LGN00"},
   {"date"=>"2013-06-13T09:39:00", "id"=>"LC8_L1T_TOA/LC81870522013164LGN00"},
   ...
  ]}}

Parameters

Parameter Type Mandatory Description
lat Float Yes Latitude
lon Float Yes Longitude
begin String (format YYYY-MM-DD) No beginning of date range
end String (format YYYY-MM-DD) No end of date range