API de mapa heliocêntrico

O endpoint heliocentric converte a data, hora e desvio UTC fornecidos num dia juliano e depois solicita ao motor Swiss Ephemeris as posições planetárias referidas ao centro do Sol em vez da Terra. Nesta estrutura, a Terra surge como um corpo em órbita com a sua própria longitude, enquanto a Lua — que orbita a Terra, não o Sol — e o Ascendente e o Meio-Céu geocêntricos não têm significado e são omitidos. A resposta devolve as longitudes heliocêntricas dos planetas e a grelha completa de aspetos calculada entre eles, com indicadores de aplicação e separação e orbes exatos. Como o movimento heliocêntrico é constante e livre dos laços retrógrados e da paralaxe que a própria órbita da Terra introduz, o espaçamento planetário lê-se de forma muito diferente de um mapa geocêntrico — as posições refletem a geometria orbital real em torno do Sol.

curl -X POST https://api.astroway.info/v1/heliocentric \
  -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
}'

{
  "ok": true,
  "data": {
    "input": {},
    "planets": [
      {
        "name": "Earth",
        "longitude": 234.2
      },
      {
        "name": "Mars",
        "longitude": 9.1
      }
    ],
    "aspects": [
      {
        "planet1": "Earth",
        "planet2": "Jupiter",
        "type": "trine",
        "orb": 0.9
      }
    ]
  }
}

Recorra ao mapa heliocêntrico em contextos de investigação, financeiros e mundanos onde a visão centrada no Sol é o padrão analítico — modelos de temporização de mercado que acompanham ângulos planetários heliocêntricos, estudos mundanos de ciclos planetários, ou qualquer análise que queira a geometria orbital sem as distorções da retrogradação geocêntrica. É também útil como sobreposição de contraste a um mapa convencional, uma vez que um planeta que parece retrógrado a partir da Terra está simplesmente a avançar em torno do Sol aqui. Como não há Lua, nem Ascendente, nem casas no sentido geocêntrico, trate a saída como um conjunto de dados de longitude planetária e aspetos em vez de um mapa natal pessoal — responde a questões sobre ciclos e configurações, não sobre o signo ascendente de um indivíduo.

Esta é uma estrutura centrada no Sol: a Terra é devolvida como um corpo, e a Lua, o Ascendente geocêntrico e o Meio-Céu estão ausentes por construção. O movimento retrógrado desaparece porque é um artefacto da observação a partir de uma Terra em movimento. A saída lê-se melhor como longitudes heliocêntricas mais a sua grelha de aspetos para trabalho de ciclos e mundano, não como um mapa pessoal. Longitudes tropicais e Swiss Ephemeris ao longo de tudo.