API de astrocartografia de revolução solar

O endpoint constrói primeiro o mapa natal e depois procura o instante no ano pedido em que o Sol em trânsito atinge a longitude solar natal, com uma precisão bem inferior a um segundo de arco. Calcula as posições planetárias para esse instante e traça as quatro famílias de linhas angulares por todo o mundo, exatamente como o endpoint de astrocartografia natal, devolvendo sessenta e três linhas. Cada nome de planeta leva um sufixo SR, para que um cliente que renderize ambos os mapas em simultâneo não confunda uma linha de Júpiter natal com uma de revolução solar. As linhas são devolvidas como pares de coordenadas no mesmo formato de /acg, por isso um renderizador existente não precisa de alterações além de um estilo para a segunda camada.

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

{
  "ok": true,
  "data": {
    "year": 2026,
    "lines": [
      {
        "planet": "Sun (SR)",
        "planetId": 0,
        "type": "MC",
        "coordinates": [[-85, 110.4845], [-84.5, 110.4845], "…"]
      }
    ]
  }
}

Este é o endpoint por trás da pergunta mais comercial da astrologia de relocalização: onde devo passar o meu aniversário e onde devo estar baseado este ano. Os mapas de revolução solar são tradicionalmente calculados para o local onde a pessoa está fisicamente no momento do retorno, o que torna a localização uma decisão e não um dado, e este mapa é o que transforma essa decisão em algo que o utilizador pode ver. Constrói um relatório anual de relocalização, um recomendador de viagens de aniversário ou uma camada anual sobre o teu mapa de astrocartografia existente. Como o momento do retorno muda todos os anos, o resultado é conteúdo naturalmente recomprável em vez de um cálculo único, e combina diretamente com /solar-return quando o utilizador quer o mapa além da carta.

As posições vêm do Swiss Ephemeris (Astrodienst). O instante do retorno é resolvido contra a longitude solar natal no zodíaco tropical; as revoluções solares siderais são uma técnica diferente e não são o que este endpoint calcula. O mapa é desenhado apenas a partir da carta do retorno, por isso é uma substituição completa das linhas natais para esse ano, e não uma modificação delas. Algumas escolas calculam o retorno para o local de nascimento em vez da localização atual; essa escolha pertence à tua camada de interpretação, já que a geometria das linhas é idêntica de qualquer forma.