Parans API

L'endpoint résout le moment de naissance en un jour julien, calcule l'ensemble complet d'astrocartographie (quatre lignes angulaires par corps), puis intersecte chaque ligne avec chaque ligne appartenant à une planète différente. Chaque intersection est renvoyée avec les deux planètes parentes, les deux types de lignes, et la latitude et longitude où le croisement se produit. Comme les lignes MC et IC sont des méridiens et les lignes AC et DC des courbes dépendantes de la latitude, la plupart des croisements sont géométriques plutôt que symétriques : une paire Soleil-MC et Lune-ASC se rencontre à exactement un endroit par hémisphère, pas sur une bande partagée. Un thème typique produit quelque chose comme quatre cents croisements à travers le globe, c'est pourquoi ils sont renvoyés comme une liste plate, triable, plutôt que pré-filtrés par aucune notion d'importance.

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

Utilisez les parans lorsque les lignes d'astrocartographie seules sont trop grossières. Les lignes indiquent à un utilisateur qu'un corridor porte Jupiter ; les parans leur disent qu'à un endroit précis de ce corridor Jupiter rencontre Vénus. Cette distinction est ce pour quoi les consultants en relocation facturent, et c'est la couche que la plupart des outils cartographiques sautent. Pratiquement : affichez les lignes comme des polylignes et les parans comme des marqueurs cliquables, ou filtrez la liste aux paires de planètes que votre produit prend en charge et classez les villes proches par proximité à ces points. La réponse ne contient que des coordonnées, vous pouvez donc l'associer à votre propre jeu de données de ville ou de région sans avoir à gérer un format en prose. Notez que cet endpoint n'a pas besoin du lieu de naissance, seulement du moment, puisque les croisements sont des propriétés du ciel plutôt que de l'endroit où la personne se trouvait.

Les positions proviennent de l'Éphéméride Suisse (Astrodienst) compilée en WASM, le même moteur que les endpoints nataux, donc les parans s'ancrent aux mêmes longitudes planétaires que les lignes dont ils dérivent. Les croisements sont calculés dans le zodiaque tropical à partir de la géométrie complète de la ligne plutôt qu'à partir d'une approximation de latitude. La doctrine paran classique telle qu'établie par Bernadette Brady traite également les parans étoile-planète, et les rapporte comme une latitude plutôt qu'un point ; ce cas a son propre endpoint, [parans étoile-planète](/astrology-api/star-parans/). Celui-ci couvre le cas planète-planète que la carte d'astrocartographie génère elle-même.