Terra - API de Datos Astronómicos - Especificaciones Técnicas

Capacidades Principales

Usamos la biblioteca Swiss Ephemeris, que garantiza una precisión a nivel JPL DE440 (estándar 2021) para todas las posiciones planetarias.

Cálculos Fundamentales

  • Salida/Puesta/Tránsito (Sol/Luna)
  • Refracción atmosférica:
    • Sol: -0.833°
    • Luna: -0.583°
  • Modelo atmosférico fijo: 1013.25 hPa / 15°C
  • Correcciones topocéntricas (Boa Grande, Noia)
  • Zona horaria: Europa/Madrid

Características Avanzadas

  • Orientación terminador lunar
  • Dirección borde brillante
  • Magnitud aparente
  • Búsqueda de perigeo anual

Precisión Lunar

Parámetro Precisión Detalles
Edad de fase <0.3 días Error máximo en fase lunar
Perigeos ±4 horas Precisión temporal
Coordenadas horizontales ±0.1° Incluye modelo atmosférico
Posición eclíptica 0.000001° Precisión angular

Precisión Solar

Parámetro Precisión Detalles
Equinoccios ±30 segundos Precisión temporal
Posición <1' arco Error angular máximo
Distancia heliocéntrica 0.01 km Precisión en distancia
Ángulo de elongación 0.01° Precisión angular
Cálculo de tránsito ±15 segundos Precisión temporal

Funciones Específicas de la Luna

Fases Lunares

  • Sistema de 8 fases (22.5°)
  • Iluminación: 0.1%
  • Edad lunar: 0.1 días

Mecánica Celeste

  • Detección de perigeos/apogeos
  • Búsqueda hacia adelante: 30 días
  • Predicción mareas vivas
  • Paralaje: 0.0001°

Predicción de Mareas

Mareas para Portosin, usando datos calculados y convertidos del Instituto Hidrográfico de la Marina.

Ejemplo de Respuesta

Consulta la documentación detallada para las explicaciones completas de todos los campos.

{
  "timestamp": "2025-07-20T21:09:13+02:00",
  "location": { ... },
  "sun": { ... },
  "moon": { ... },
  "tides": [ ... ]
}