API de Direções de Arco Solar

A partir dos dados de nascimento e de uma data alvo, o endpoint primeiro progride o mapa dia-por-ano, mede quão longe o Sol progredido se deslocou da sua posição natal e toma essa distância como o arco. Depois adiciona o arco a todas as longitudes natais de uma vez: todos os planetas, todas as cúspides das casas, o ascendente e o MC. A resposta traz as posições dirigidas em data.planets e data.houses, o arco em graus em data.arc, e a chave que o gerou em data.key. Como um único arco é aplicado uniformemente, a geometria do mapa natal é preservada e só a sua relação com os graus natais muda, o que torna a técnica tão económica de ler: um número diz-te o estado de todo o mapa numa dada idade. Dois outras chaves estão disponíveis no mesmo endpoint. Define key como naibod para a taxa solar média de 59'08.3" por ano, ou omite-a para o simples um grau por ano. Enviar converse true dirige para trás a partir do momento de nascimento em vez de para a frente, invertendo o sinal do arco.

curl -X POST https://api.astroway.info/v1/symbolic-directions \
  -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,
  "targetDate": "2026-05-15",
  "key": "solar_arc"
}'

{
  "ok": true,
  "data": {
    "arc": 34.5083,
    "key": "solar_arc",
    "planets": [
      {
        "id": 0,
        "name": "Sun",
        "longitude": 88.8843,
        "isRetrograde": false
      }
    ],
    "houses": {
      "system": "P",
      "ascendant": 204.4763,
      "mc": 111.5826
    }
  }
}

Usa o arco solar quando precisas de uma temporização simbólica em vez de astronómica, e quando queres algo numa forma que o leitor possa seguir. Como tudo se move a uma taxa única, um contacto dirigido aterra num ano específico em vez de numa janela, o que encaixa numa funcionalidade de linha de vida, num relatório de marcos de idade, ou numa narrativa de IA que tem de dizer o que um determinado ano representa. Combina naturalmente com progressões secundárias, já que o arco deriva do mesmo Sol progredido: as progressões dão-te o mapa interno em movimento, o arco solar dá-te todo o mapa traduzido para a frente. Compara as três chaves quando a precisão importa ao teu público. O arco solar segue o Sol real e varia ligeiramente consoante a data de nascimento, Naibod usa a taxa média, e um grau por ano é a convenção de número redondo. Para um nascimento em meados de maio, os três resultam em cerca de 34,5, 35,5 e 36,0 graus ao longo de 36 anos, suficientemente próximos para concordar na década e suficientemente afastados para nomear anos diferentes.

O arco é a distância percorrida pelo Sol secundariamente progredido, dia por ano, que é a definição padrão; a chave Naibod usa o movimento diário médio do Sol, 59'08.3" por ano. Para o arco solar o mapa progredido é calculado para a frente e a direção de viagem é aplicada uma única vez, por isso as direções converse devolvem o arco negado em vez de duplicado. As posições provêm do motor Swiss Ephemeris no zodíaco tropical, nos mesmos corpos e sistema de casas dos endpoints natais.