Solar Arc Directions API

출생 데이터와 목표 날짜를 받아서, 이 endpoint는 먼저 차트를 하루를 1년으로 진행하고, 진행된 Sun이 출생 위치에서 얼마나 이동했는지 재서 그 거리를 아크로 잡아. 그 다음 그 아크를 모든 출생 경도에 한 번에 더해: 모든 행성, 모든 하우스 궁두점, 상승점과 MC까지. 응답은 data.planets와 data.houses 아래에 방향이 지정된 위치를, data.arc 아래에 아크(도) 값을, data.key 아래에 만든 키를 담아. 하나의 아크가 균일하게 적용돼서 출생 차트의 기하학은 유지되고 출생도와의 관계만 바뀌어, 이 기법이 읽기 쉬운 이유야: 하나의 숫자로 특정 나이에 전체 차트 상태를 알 수 있어. 같은 endpoint에 두 개의 다른 키도 있어. key를 naibod로 설정하면 연간 평균 태양 속도인 59'08.3"를 쓰고, 빼면 연 1도 기본값을 써. converse를 true로 보내면 출생 순간부터 뒤로 진행해서 아크 부호가 반대로 돼.

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

천문학보다 상징적인 타이밍이 필요하고, 독자가 따라가기 쉬운 형태가 필요할 때 solar arc를 써. 모든 것이 같은 속도로 움직이니까, 지정된 접촉이 특정 연도에 정확히 맞아, 그래서 인생 타임라인 기능, 연령 마일스톤 보고서, 혹은 AI 서술이 특정 연도에 대해 말해야 할 때 딱이야. 2차 진행과도 자연스럽게 짝을 이루어, 아크가 같은 진행된 Sun에서 나오니까: 진행은 내부 차트를 움직이고, solar arc는 전체 차트를 앞으로 옮겨. 정확도가 청중에게 중요하면 세 가지 키를 비교해. solar arc는 실제 Sun을 따라서 출생일에 따라 조금씩 달라지고, Naibod는 평균 속도를 쓰고, 연 1도는 반올림 숫자 관습이야. 5월 중순에 태어난 경우, 36년 동안 대략 34.5°, 35.5°, 36.0°가 나오는데, 십년대를 맞추기에 충분하고 서로 다른 연도를 구분하기엔 충분히 차이가 나.

아크는 2차 진행된 Sun이 하루를 1년으로 이동한 거리이며, 표준 정의야; Naibod 키는 Sun의 평균 일일 움직임인 59'08.3" per year를 사용해. solar arc에서는 진행된 차트를 앞으로 계산하고 이동 방향을 한 번만 적용해서, converse 방향은 아크를 부정해서 반환하고 두 배가 아니야. 위치는 Swiss Ephemeris 엔진에서 열대 황도대 기준으로, 출생 endpoint와 같은 천체와 하우스 시스템을 사용해 가져와.