API de Parans

El endpoint resuelve el momento de nacimiento a un día juliano, calcula el conjunto completo de astrocartografía (cuatro líneas angulares por cuerpo), e intersecta cada línea con cada línea perteneciente a un planeta diferente. Cada intersección se devuelve con ambos planetas padres, ambos tipos de líneas, y la latitud y longitud donde cae el cruce. Debido a que las líneas MC e IC son meridianos y las líneas AC y DC son curvas dependientes de la latitud, la mayoría de los cruces son geométricos en lugar de simétricos: un par Sol-MC y Luna-ASC se encuentra en exactamente un lugar por hemisferio, no en una banda compartida. Un gráfico típico produce algo más de cuatrocientos cruces en todo el mundo, por lo que se devuelven como una lista plana y ordenable, en lugar de prefiltrados por cualquier noción de importancia.

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

{
  "ok": true,
  "data": {
    "count": 414,
    "parans": [
      {
        "planet1Id": 0,
        "planet1Name": "Sun",
        "line1Type": "MC",
        "planet2Id": 1,
        "planet2Name": "Moon",
        "line2Type": "ASC",
        "location": { "lat": -45.9153, "lng": 6.5735 }
      }
    ]
  }
}

Recurre a los parans cuando las líneas de astrocartografía solas son demasiado gruesas. Las líneas le dicen a un usuario que un corredor lleva a Júpiter; los parans le dicen que en un lugar específico de ese corredor Júpiter se encuentra con Venus. Esa distinción es por lo que los consultores de relocalización cobran, y es la capa que la mayoría de las herramientas de mapa omiten. Prácticamente: renderiza las líneas como polilíneas y los parans como marcadores clickeables, o filtra la lista a los pares de planetas que tu producto considera importantes y clasifica las ciudades cercanas por proximidad a esos puntos. La respuesta contiene solo coordenadas, por lo que puedes unirla con tu propio conjunto de datos de ciudad o región sin luchar contra un formato en prosa. Ten en cuenta que este endpoint no necesita el lugar de nacimiento, solo el momento, ya que los cruces son propiedades del cielo en lugar de del lugar donde la persona sucedió estar.

Las posiciones provienen de la Swiss Ephemeris (Astrodienst), el mismo motor que los endpoints natales, por lo que los parans se anclan a las mismas longitudes planetarias que las líneas de las que derivan. Los cruces se calculan en el zodiaco tropical a partir de la geometría completa de la línea en lugar de una aproximación de latitud. La doctrina clásica de parán establecida por Bernadette Brady también trata los parans estrella-planeta, y los informa como una latitud en lugar de un punto; ese caso tiene su propio endpoint, [parans estrella-planeta](/astrology-api/star-parans/). Este cubre el caso planeta-planeta que el mapa de astrocartografía en sí genera.