별-행성 파란스 API

각 별과 행성에 대해 이 endpoint는 네 가지 각도 이벤트(떠오름, 지남, 정점, 반정점)를 받아 두 개가 같은 지역 항성시(local sidereal time)에 같은 위도에서 일어나는지를 묻지. 정점은 항성시를 몸체의 적경에 고정하고, 떠오름과 지남은 반일주 호(半日弧)만큼 이동하는데, 이는 위도와 적위의 함수야. 총 열두 개의 이벤트 쌍을 풀고 모든 해를 보고해, 위도, 항성시, 그리고 그 순간 차트에서 쌍이 각을 이루는 자오선을 함께 제공해. 자오선 대 자오선은 제외돼: 그 조건엔 위도가 없어서 절대 성립하지 않거나 전역에 성립하는데, 전역에 성립한다는 건 두 개가 같은 적경을 공유한다는 뜻이야. 해결됐지만 결과가 없는 별은 응답에 이름으로 표시돼, 조용히 제외되지 않아. 예를 들어 폴라리스 같은 극지 별은 거의 전체 범위에서 이런 일이 일어나.

curl -X POST https://api.astroway.info/v1/parans/star \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "stars": ["Regulus", "Sirius"],
  "planets": [0, 4]
}'

{
  "ok": true,
  "data": {
    "type": "star-parans",
    "horizon": "geometric",
    "latitudeLimit": 60,
    "count": 16,
    "stars": [
      { "name": "Regulus", "magnitude": 1.36, "rightAscension": 151.9686, "declination": 12.0133 }
    ],
    "parans": [
      {
        "star": "Regulus",
        "starEvent": "rise",
        "planetId": 0,
        "planetName": "Sun",
        "planetEvent": "culminate",
        "latitude": 39.1022,
        "longitude": 6.5735,
        "lst": 51.6
      }
    ]
  }
}

차트의 고정 별 레이어가 단순한 합성 리스트보다 더 필요할 때 써. 별이 황도 경도 기준으로 행성과 합성되는 건 투영일 뿐이고, 파란은 별과 행성이 실제로 각도에 같이 서 있는 상황이야. 이게 Brady가 만든 관계이고 별을 지도상의 위치와 연결해. 재배치 제품에서는 위도가 가로 밴드로 표시되고, 그 밴드 위에 있는 도시는 해당 별-행성 조합을 갖게 돼. 이 endpoint는 출생지를 요구하지 않아, 순간만 있으면 돼: 어떤 위도가 존재하는지는 하늘의 속성이지 사람의 출생지와는 무관해.

시각각(hour angle)으로 풀어서 지도 폴리라인 교차로가 아니라 정확한 위도를 얻었어, 폴리라인 단계로 양자화되지 않아. 별의 실제 적위도 사용했지, 황도도에 투영된 것이 아니라. 이 차이가 중요해: 베가는 황도 위도 61도, 시리우스는 -39도라서 그들이 차지하는 정도가 실제 상승 시점과는 멀리 떨어져. 별 위치는 Swiss Ephemeris 고정 별 카탈로그에서 가져왔고, 황도-적도 변환은 행성을 돌려가며 에페머리스 자체와 확인했어. Brady가 만든 Castor 예시는 1도 이내로 재현됐지만, 그녀가 기하학적 지평선이나 겉보기 지평선을 썼는지는 확정되지 않았어. 두 방법은 파란 위도 약 2도 차이가 나서, 그 선택은 요청 파라미터로 지정하고 기본값은 조용히 정해두지 않아.