Voyager is a swiss army knife library for the NASA Open APIs. It is designed to bundle all the NASA APIs into a single package. Voyager can be used to gather data from a variety of NASA's endpoints, including: Picture of The Day, Solar Flares, Magnetic Storms, Near Earth Objects etc.
Future versions of voyager will strive to incorporate more endpoints, until all of them are integrated.
Let's see how we can use the voyagerclient in our Rust projects. ```rust use voyagerclient::{donki_client, timing};
fn main() {
// Setup Timing Parameters for Query
let start = String::from("2019-01-01");
let end = String::from("2022-01-01");
// Instantiate Base Client
let base = donki_client::Solar::new(start, end);
// Query the API
let res = base.query().unwrap();
}
``` Notice we must supply a start and end date to our function in which we instantiate our base client. This is because NASA's endpoints are constantly being updated with new data. If our queries have too long of a time range, it's likely to timeout before processing our request. This way, it's more of a concious decision in how wide of a range you want to query for.
To build the voyager binaries, run:
sh
cargo build --release
sh
bash install.sh
Once you have the binaries installed, you must first configure your API key to use with voyager.
If you have one already setup through NASA, you can simply run the following command:
sh
voyager set key [YOUR_API_KEY]
If you don't have an API key yet, you can visit NASA's Open API Documentation to set one up. Then run the command above to link your key with voyager. The key will be written to /Users/you/voyager/.api_key.txt.
sh
voyager get key
Run this command to ensure voyager has saved your key properly.