from rotastellar import RotaStellarClient

client = RotaStellarClient(api_key="rs_...")

# Get satellite by NORAD ID
iss = client.get_satellite("25544")  # ISS

# Current position
print(f"Location: {iss.position.latitude}, {iss.position.longitude}")
print(f"Altitude: {iss.position.altitude_km} km")

# Orbital parameters
print(f"Period: {iss.orbit.orbital_period_minutes} minutes")
print(f"Inclination: {iss.orbit.inclination_deg} deg")

import { RotaStellarClient } from '@rotastellar/sdk';

const client = new RotaStellarClient({ apiKey: 'rs_...' });

// Get satellite
const iss = await client.getSatellite('25544');  // ISS

// Current position
console.log(`Location: ${iss.position?.latitude}, ${iss.position?.longitude}`);
console.log(`Altitude: ${iss.position?.altitudeKm} km`);

// Orbital parameters
console.log(`Period: ${iss.orbit?.periodMin} minutes`);

use rotastellar::types::{Position, Orbit};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Rust SDK provides types only (HTTP client coming soon)
    // Use Python or Node.js SDK for full API access

    let pos = Position::new(41.264, -95.123, 420.5)?;
    println!("Location: {}, {}", pos.latitude, pos.longitude);
    println!("Altitude: {} km", pos.altitude_km);

    Ok(())
}

curl https://api.rotastellar.com/v1/satellites/ISS \
  -H "Authorization: Bearer rs_your_api_key"

starlinks = client.list_satellites(
    constellation="Starlink",
    limit=100
)

for sat in starlinks:
    print(f"{sat.name}: {sat.position.altitude_km} km")

curl "https://api.rotastellar.com/v1/satellites?constellation=Starlink&limit=100" \
  -H "Authorization: Bearer rs_your_api_key"

from datetime import datetime, timedelta

# Where will ISS be in 2 hours?
future = (datetime.utcnow() + timedelta(hours=2)).isoformat()

pos = client.get_satellite_position("25544", at=future)
print(f"Predicted: {pos.latitude}, {pos.longitude}")

curl "https://api.rotastellar.com/v1/satellites/ISS/position?at=2026-01-21T14:00:00Z" \
  -H "Authorization: Bearer rs_your_api_key"

from datetime import datetime, timedelta

trajectory = client.get_trajectory(
    satellite_id="25544",
    start=datetime.utcnow().isoformat(),
    end=(datetime.utcnow() + timedelta(hours=24)).isoformat(),
    interval_sec=300  # Every 5 minutes
)

for point in trajectory:
    print(f"{point['timestamp']}: {point['lat']}, {point['lon']}")

curl "https://api.rotastellar.com/v1/satellites/ISS/trajectory?start=2026-01-21T00:00:00Z&end=2026-01-22T00:00:00Z&interval_sec=300" \
  -H "Authorization: Bearer rs_your_api_key"