Parans API

O endpoint resolve o momento de nascimento para um dia Juliano, calcula o conjunto completo de astrocartografia (quatro linhas angulares por corpo), e depois intersecta cada linha com cada linha pertencente a um planeta diferente. Cada interseção é devolvida com ambos os planetas pais, ambos os tipos de linha, e a latitude e longitude onde o cruzamento ocorre. Como as linhas MC e IC são meridianos e as linhas AC e DC são curvas dependentes da latitude, a maioria dos cruzamentos são geométricos em vez de simétricos: um par Sol-MC e Lua-ASC encontra-se em exatamente um local por hemisfério, não numa faixa partilhada. Um mapa típico gera mais de quatrocentos cruzamentos ao redor do globo, razão pela qual são devolvidos como uma lista plana e ordenável em vez de pré-filtrados por qualquer noção de importância.

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

Recorre aos parans quando as linhas de astrocartografia sozinhas são demasiado grosseiras. As linhas dizem ao utilizador que um corredor tem Júpiter; os parans dizem-lhe que num ponto específico desse corredor Júpiter encontra Vénus. Essa distinção é o que os consultores de relocação cobram, e é a camada que a maioria das ferramentas de mapa ignora. Na prática: renderiza as linhas como polilinhas e os parans como marcadores clicáveis, ou filtra a lista para os pares de planetas que o teu produto considera e classifica as cidades próximas pela proximidade a esses pontos. A resposta contém apenas coordenadas, para que possas juntá-las ao teu próprio conjunto de dados de cidades ou regiões sem lutar contra um formato de texto. Nota que este endpoint não precisa de local de nascimento, apenas do momento, já que os cruzamentos são propriedades do céu e não do local onde a pessoa se encontrava.

As posições vêm da Swiss Ephemeris (Astrodienst), o mesmo motor dos endpoints natais, por isso os parans ancoram nas mesmas longitudes planetárias das linhas das quais derivam. Os cruzamentos são calculados no zodíaco tropical a partir da geometria completa das linhas e não a partir de uma aproximação de latitude. A doutrina clássica dos parans, como definida por Bernadette Brady, também trata dos parans estrela-planeta, e reporta-os como uma latitude em vez de um ponto; esse caso tem o seu próprio endpoint, [parans estrela-planeta](/astrology-api/star-parans/). Este cobre o caso planeta-para-planeta que o próprio mapa de astrocartografia gera.