태양 귀환 API

solar-return 엔드포인트는 먼저 제공된 출생 데이터에서 출생 태양의 정확한 황도 경도를 읽어. 그런 다음 해당 연도에서 이동하는 태양이 같은 경도에 다시 돌아오는 정확한 순간을 찾는데, 보통 생일 전후 하루 안에 찾아. 그 반환 순간을 Julian day 로 변환하고, Swiss Ephemeris 엔진에서 지구 중심 위치와 속도를 가져와서 전체 차트를 만든다: 반환 행성들의 별자리와 하우스 위치, 하우스 꼭짓점, 적용·분리 플래그와 정확한 오비가 표시된 전체 어스펙트 그리드. 매치는 열대와 Sun-to-natal-Sun이며 기본적으로 프리세션 보정되지 않아 반환 태양이 출생 태양의 열대도에 놓인다. 결과 차트는 한 생일에서 다음 생일까지의 연도 주제 지도로 읽힌다.

curl -X POST https://api.astroway.info/v1/solar-return \
  -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": {
    "input": {},
    "planets": [
      {
        "name": "Sun",
        "longitude": 54.23,
        "sign": "Taurus",
        "house": 9
      }
    ],
    "houses": {
      "ascendant": 188.2,
      "mc": 95,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      "…"
    ]
  }
}

태양 귀환을 연간 예측에 써 - '다음 해' 보고서, 생일 차트 기능, 혹은 하나의 날짜 차트로 12개월 전망을 만드는 AI 흐름에 활용해. 반환 기반 예측의 핵심 도구라서 각도, 반환 태양이 위치한 하우스, 가장 강한 어스펙트가 그 해의 주요 테마로 읽혀. 트랜짓과 진행과 함께 쓰면 깊이가 더해지지만, 태양 귀환만으로도 캘린더가 아니라 사람의 생일에 맞춘 깔끔한 연간 스냅샷을 제공해. 출생 데이터와 연도만 넘겨주면 기념일 트리거와 연간 이메일 일정에 딱 맞아 - 매년 다시 계산해서 예측을 이어갈 수 있어.

귀환은 열대 기준으로, Sun to natal Sun 로 매치되고 기본적으로 프리세션 보정되지 않아 서구식 전통 태양 귀환을 반영해, 별자리 보정 버전이 아니라. 제공된 출생 위치를 기준으로 차트를 만들고, 위치를 바꾸려면 다시 차트를 그려야 해. 전체적으로 열대 황도와 Swiss Ephemeris 를 사용해.