태양 귀환 아스트로카르토그래피 API

엔드포인트는 먼저 출생 차트를 만들고, 요청한 연도에 이동하는 태양이 출생 태양 경도에 도달하는 순간을 초당 1초 이하 정밀도로 찾는다. 그 순간의 행성 위치를 계산하고, 네 개의 각도선 군을 전 세계에 그려, 출생 아스트로카르토그래피 엔드포인트와 똑같이 63개의 선을 반환해. 모든 행성 이름에 SR 접미사가 붙어 있어 두 지도를 동시에 렌더링하는 클라이언트가 출생 목성 선과 태양 귀환 목성 선을 혼동하지 않게 해. 선들은 /acg와 같은 형태의 좌표 쌍으로 반환되니 기존 렌더러는 두 번째 레이어 스타일만 추가하면 돼.

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], "…"]
      }
    ]
  }
}

이 엔드포인트는 이주 점성술에서 가장 상업적인 질문, 즉 '생일은 어디서 보내고, 올해는 어디에 기반을 두어야 할까'에 답해. 태양 귀환 차트는 보통 귀환 시점에 사람이 실제로 있는 곳을 기준으로 만들기 때문에 위치가 주어진 것이 아니라 선택이 돼, 그리고 이 지도는 그 선택을 사용자가 볼 수 있게 해줘. 연간 이주 보고서, 생일 여행 추천, 혹은 기존 아스트로카르토그래피 지도 위에 연간 오버레이를 만들 수 있어. 기본 귀환 순간이 매년 바뀌니 결과가 일회성 계산이 아니라 자연스럽게 재구매 가능한 콘텐츠가 되고, 사용자가 차트와 지도를 모두 원할 때 /solar-return과 바로 결합돼.

위치는 Swiss Ephemeris (Astrodienst)에서 WASM으로 컴파일된 데이터를 사용해. 귀환 순간은 열대 황도대의 출생 태양 경도와 비교해 계산돼; 별자리 태양 귀환은 다른 기법이라 이 엔드포인트가 계산하지 않아. 지도는 귀환 차트만으로 그려지니 해당 연도의 출생 선을 완전히 대체하고 수정하지 않아. 일부 학파는 현재 위치가 아니라 출생지를 기준으로 귀환을 계산하는데, 그 선택은 네 해석 레이어에 달려 있어, 선 형태는 어느 쪽이든 동일하거든.