Parans API

L'endpoint risolve il momento di nascita in un giorno giuliano, calcola l'intero set di astrocartografia (quattro linee angolari per corpo celeste) e poi interseca ogni linea con ogni linea appartenente a un pianeta diverso. Ogni incrocio viene restituito con entrambi i pianeti genitori, entrambi i tipi di linea e la latitudine e longitudine in cui cade l'incrocio. Poiché le linee MC e IC sono meridiani e le linee AC e DC sono curve dipendenti dalla latitudine, la maggior parte degli incroci è geometrica piuttosto che simmetrica: una coppia Sole-MC e Luna-ASC si incontra in esattamente un punto per emisfero, non su una banda condivisa. Un tipico grafico produce oltre quattrocento incroci in tutto il mondo, per cui vengono restituiti come una lista piatta e ordinabile anziché pre-filtrati per qualsiasi nozione di importanza.

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 }
      }
    ]
  }
}

Ricorri ai parans quando le sole linee di astrocartografia sono troppo generiche. Le linee dicono a un utente che un corridoio trasporta Giove; i parans gli dicono che in un punto specifico di quel corridoio Giove incontra Venere. Tale distinzione è ciò per cui i consulenti di relocation fanno pagare, ed è il livello che la maggior parte degli strumenti di mappa saltano. Praticamente: rendi le linee come polilinee e i parans come marcatori cliccabili, o filtra l'elenco alle coppie di pianeti di cui il tuo prodotto si occupa e classifica le città vicine per prossimità a quei punti. La risposta contiene solo coordinate, quindi puoi unirle al tuo dataset di città o regioni senza combattere con un formato in prosa. Nota che questo endpoint non richiede il luogo di nascita, solo il momento, poiché gli incroci sono proprietà del cielo piuttosto che del luogo in cui si trovava la persona.

Le posizioni provengono dall'Ephemeris Svizzera (Astrodienst), lo stesso motore degli endpoint natali, quindi i parans si ancorano alle stesse longitudini planetarie delle linee da cui derivano. Gli incroci vengono calcolati nello zodiaco tropicale dalla geometria completa della linea piuttosto che da un'approssimazione di latitudine. La dottrina classica dei parans, come esposta da Bernadette Brady, tratta anche i parans stella-pianeta e li riporta come latitudine piuttosto che come punto; quel caso ha il proprio endpoint, [parans stella-pianeta](/astrology-api/star-parans/). Questo copre il caso pianeta-pianeta che la mappa di astrocartografia stessa genera.