Struct NasaClient 

pub struct NasaClient { /* private fields */ }

Client for NASA Open APIs (api.nasa.gov)

Provides access to:

• Astronomy Picture of the Day (APOD)
• Near Earth Objects (NEO) - asteroids
• Mars weather and rover photos
• Space weather events (DONKI)

Example

use ruvector_data_framework::NasaClient;

let client = NasaClient::new(Some("YOUR_API_KEY".to_string()))?;
let apod = client.get_apod(None).await?;
let asteroids = client.search_neo("2024-01-01", "2024-01-07").await?;
let mars_photos = client.search_mars_photos(1000, Some("NAVCAM")).await?;

Implementations

impl NasaClient

pub fn new(api_key: Option<String>) -> Result<Self>

Create a new NASA client

Arguments

• api_key - Optional NASA API key (get from https://api.nasa.gov/) If None, uses “DEMO_KEY” (limited to 30 requests per hour)

pub async fn get_apod(&self, date: Option<&str>) -> Result<Vec<SemanticVector>>

Get Astronomy Picture of the Day

Arguments

• date - Optional date in format “YYYY-MM-DD”. If None, returns today’s APOD

Example

let today = client.get_apod(None).await?;
let specific = client.get_apod(Some("2024-01-01")).await?;

pub async fn search_neo( &self, start_date: &str, end_date: &str, ) -> Result<Vec<SemanticVector>>

Search for Near Earth Objects (asteroids) within a date range

Arguments

• start_date - Start date in format “YYYY-MM-DD”
• end_date - End date in format “YYYY-MM-DD” (max 7 days from start)

Example

let asteroids = client.search_neo("2024-01-01", "2024-01-07").await?;

pub async fn get_mars_weather(&self) -> Result<Vec<SemanticVector>>

Get Mars weather data (note: InSight mission ended, returns historical data)

Example

let weather = client.get_mars_weather().await?;

pub async fn search_mars_photos( &self, sol: u32, camera: Option<&str>, ) -> Result<Vec<SemanticVector>>

Search Mars Rover photos

Arguments

• sol - Martian day (sol) number
• camera - Optional camera name (FHAZ, RHAZ, MAST, CHEMCAM, MAHLI, MARDI, NAVCAM, PANCAM, MINITES)

Example

let photos = client.search_mars_photos(1000, Some("NAVCAM")).await?;
let all_cameras = client.search_mars_photos(1000, None).await?;

pub async fn get_donki_events( &self, event_type: &str, start_date: &str, end_date: &str, ) -> Result<Vec<SemanticVector>>

Get space weather events from DONKI (Database Of Notifications, Knowledge, Information)

Arguments

• event_type - Event type: “CME” (Coronal Mass Ejection), “FLR” (Solar Flare), “SEP” (Solar Energetic Particle), etc.
• start_date - Start date in format “YYYY-MM-DD”
• end_date - End date in format “YYYY-MM-DD” (max 30 days)

Example

let flares = client.get_donki_events("FLR", "2024-01-01", "2024-01-31").await?;
let cmes = client.get_donki_events("CME", "2024-01-01", "2024-01-31").await?;