0rbix / docs /SSC_API_INTEGRATION.md
nicolasleiva's picture
Initial commit: Add complete Orbix project
3dc2617

Integraci贸n con la API del Space Science Center (SSC)

Este documento describe la integraci贸n de Orbix con la API del Space Science Center (SSC) de la NASA para obtener datos orbitales reales de sat茅lites.

Descripci贸n General

La API SSC proporciona acceso a datos orbitales hist贸ricos y en tiempo real de sat茅lites y observatorios espaciales. Esta integraci贸n permite a Orbix:

  • Obtener una lista de sat茅lites disponibles
  • Recuperar datos de trayectorias orbitales para sat茅lites espec铆ficos
  • Utilizar datos reales para an谩lisis de colisiones y optimizaci贸n de rutas

Configuraci贸n

La integraci贸n requiere las siguientes variables de entorno:

SSC_API_URL=https://sscweb.gsfc.nasa.gov/WS/sscr/2
SSC_API_KEY=YourApiKeyHere

Estas variables se pueden configurar en un archivo .env en la ra铆z del proyecto o directamente en el entorno de ejecuci贸n.

Uso en el C贸digo

Inicializaci贸n del Cliente

from orbix.ssc_api import SSCApi

ssc_api = SSCApi()

Obtener Sat茅lites Disponibles

available_satellites = ssc_api.get_available_satellites()
print(f"Sat茅lites disponibles: {available_satellites}")

Obtener Datos de Trayectoria

from datetime import datetime, timedelta

now = datetime.now()
yesterday = now - timedelta(days=1)

# Obtener datos de un sat茅lite para las 煤ltimas 24 horas
satellite_data = ssc_api.get_satellite_data(
    satellites=["themisa"],  # ID del sat茅lite
    start_time=yesterday,
    end_time=now,
    resolution_factor=1  # 1 = m谩xima resoluci贸n
)

# Procesar los datos
if "satellites" in satellite_data and "themisa" in satellite_data["satellites"]:
    trajectory = satellite_data["satellites"]["themisa"]
    print(f"Obtenidos {len(trajectory)} puntos de trayectoria")

Endpoints de la API

La integraci贸n expone los siguientes endpoints en la API de Orbix:

GET /ssc/satellites

Devuelve la lista de sat茅lites disponibles en la API SSC.

Respuesta:

{
  "satellites": ["themisa", "themisb", "goes13", ...]
}

GET /ssc/satellite/{satellite_id}/data

Obtiene datos de trayectoria para un sat茅lite espec铆fico.

Par谩metros:

  • days (opcional): N煤mero de d铆as hacia atr谩s para obtener datos (predeterminado: 1)
  • resolution (opcional): Factor de resoluci贸n (1=m谩xima resoluci贸n, predeterminado: 1)

Respuesta:

{
  "satellites": {
    "themisa": [
      {
        "time": "2