API de paralajes estrella-planeta

Para cada estrella y planeta, el endpoint toma los cuatro eventos angulares (amanecer, ocaso, culminación, anticulminación) y pregunta en qué latitud los dos ocurren al mismo tiempo sidereal local. La culminación fija el tiempo sidereal en la ascensión recta del cuerpo; el amanecer y el ocaso lo mueven por el arco semidiurno, que es una función de la latitud y la declinación. Cada uno de los doce pares de eventos se resuelve y se informa cada raíz, con la latitud, el tiempo sidereal y el meridiano donde el par es angular en este momento particular del gráfico. Se rechaza meridiano contra meridiano: esa condición no tiene latitud en ella, por lo que nunca se cumple o se cumple en todas partes, y cumplirse en todas partes solo significa que los dos comparten una ascensión recta. Las estrellas que se resolvieron pero no produjeron nada se nombran en la respuesta en lugar de ser eliminadas silenciosamente, lo que le sucede a una estrella circumpolar como Polaris en casi todo el rango.

curl -X POST https://api.astroway.info/v1/parans/star \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "stars": ["Regulus", "Sirius"],
  "planets": [0, 4]
}'

{
  "ok": true,
  "data": {
    "type": "star-parans",
    "horizon": "geometric",
    "latitudeLimit": 60,
    "count": 16,
    "stars": [
      { "name": "Regulus", "magnitude": 1.36, "rightAscension": 151.9686, "declination": 12.0133 }
    ],
    "parans": [
      {
        "star": "Regulus",
        "starEvent": "rise",
        "planetId": 0,
        "planetName": "Sun",
        "planetEvent": "culminate",
        "latitude": 39.1022,
        "longitude": 6.5735,
        "lst": 51.6
      }
    ]
  }
}

Úsalo cuando la capa de estrellas fijas de un gráfico necesita ser más que una lista de conjunciones. Una estrella conjunta a un planeta por longitud zodiacal es una proyección; un paralaje es la estrella y el planeta realmente parados juntos sobre los ángulos, que es la relación sobre la que se construye el trabajo de Brady y la que une una estrella a un lugar en el mapa. En un producto de reubicación, las latitudes se trazan como bandas horizontales, y una ciudad que se sienta en una lleva ese emparejamiento estrella-planeta. Ten en cuenta que el endpoint no necesita lugar de nacimiento, solo el momento: qué latitudes existen es una propiedad del cielo, no de dónde nació la persona.

Se resuelve en ángulos horarios en lugar de por intersección de polilíneas de mapa, por lo que la latitud es exacta en lugar de cuantizada al paso de la polilínea, y se usa la declinación real de la estrella en lugar del grado zodiacal en el que proyecta. Esa distinción importa: Vega está en latitud eclíptica de 61 grados y Sirio en menos 39, por lo que el grado que ocupan no se levanta en ningún lugar cerca cuando ellos lo hacen. Las posiciones de las estrellas provienen del catálogo de estrellas fijas de Swiss Ephemeris, y la conversión eclíptica a ecuatorial se verifica contra el propio efeméris al hacer pasar los planetas por él. El ejemplo de Castor trabajado por Brady se reproduce dentro de un grado; no se resuelve si usó el horizonte geométrico o el aparente, y como los dos difieren en unos dos grados de latitud de paralaje, esa elección es un parámetro de solicitud en lugar de un silencioso predeterminado.