판창 (베다 알만악)

판찬가(पञ्चाङ्ग, “다섯 요소”)는 특정 날짜와 지리 정보를 위한 베다 달력이다. 다섯 주요 구성요소(tithi, vara, nakshatra, yoga, karana)는 결혼부터 제품 출시까지 행동에 적합한 시간을 결정한다. AstroWay는 이 다섯 요소와 추가 시간 슬롯(choghadia, hora, rahu-kaal)을 하나의 API로 제공한다.

우리가 계산하는 것

Tithi (달의 날): 30 tithi가 신월 주기에 있으며, 각각은 달-태양 12° 차이이다. 대부분의 무후르트에 대한 핵심 지표다.
Karana (반 티티): 11 karana, 각각 6° 길이. 하루의 활동을 분류한다.
Yoga (결합): 27 yoga, 태양과 달의 경도 합을 13°20’로 나눈 것. 하루의 에너지 특성이다.
Nakshatra-of-day: 날짜에 대한 주요 별자리 위치 (하루에 여러 개가 있을 경우 전환 표시 포함).
Choghadia: 8개의 낮 슬롯과 8개의 밤 슬롯, 각각 1.5시간, “Amrit / Shubh / Labh / Char”(유리)와 “Kaal / Rog / Udveg”(불리) 표시 포함.
Hora: 행성 시간(베다 버전, 태양 상승 시점부터, 약 1시간씩 24 hora).
Rahu Kaal: 불리한 구간(하루 빛 시간의 1/8, 요일에 따라 달라짐).
Full panchang: 위 모든 정보를 하나의 요청으로 제공(데일리 위젯에 편리).

엔드포인트

엔드포인트	크레딧	반환 내용
`/v1/vedic/panchang/tithi`	20	현재 tithi와 다음 tithi로 전환 시점
`/v1/vedic/panchang/karana`	20	현재 karana와 전환 시점
`/v1/vedic/panchang/yoga`	20	현재 yoga와 전환 시점
`/v1/vedic/panchang/nakshatra-of-day`	20	당일 nakshatra + pada와 전환 시점
`/v1/vedic/panchang/choghadia`	20	16 슬롯(낮 8개 + 밤 8개)과 표시
`/v1/vedic/panchang/hora`	20	24 행성 시간
`/v1/vedic/panchang/rahu-kaal`	20	Rahu/Yama/Gulika Kaal 구간
`/v1/vedic/panchang/full`	20	위 모든 정보를 하나의 응답에 포함

예시

curl -X POST https://api.astroway.info/v1/vedic/panchang/full \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-05-11",
    "time": "06:00:00",
    "timezoneOffset": 5.5,
    "latitude": 28.6139,
    "longitude": 77.2090,
    "ayanamsa": "lahiri"
  }'

const r = await fetch('https://api.astroway.info/v1/vedic/panchang/full', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '2026-05-11',
    time: '06:00:00',
    timezoneOffset: 5.5,
    latitude: 28.6139,
    longitude: 77.2090,
    ayanamsa: 'lahiri',
  }),
});
const { data } = await r.json();
console.log(`Tithi: ${data.tithi.name}, Nakshatra: ${data.nakshatra.name}`);
console.log(`Rahu Kaal: ${data.rahuKaal.startTime} - ${data.rahuKaal.endTime}`);

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/vedic/panchang/full',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
    json={
        'date': '2026-05-11', 'time': '06:00:00', 'timezoneOffset': 5.5,
        'latitude': 28.6139, 'longitude': 77.2090,
        'ayanamsa': 'lahiri',
    },
)
data = r.json()['data']
print(f"Tithi: {data['tithi']['name']}, Nakshatra: {data['nakshatra']['name']}")

응답 예시

{
  "jd": 2461171.520833,
  "ayanamsa": 24.225277,
  "sunrise": "05:33:04",
  "sunset": "19:02:21",
  "tithi": {
    "number": 24,
    "name": "Navami",
    "paksha": "krishna",
    "indexInPaksha": 9,
    "elongation": 283.301369,
    "percentComplete": 0.608447
  },
  "vara": { "number": 1, "name": "Somavara", "ruler": "Moon" },
  "karana": { "index": 48, "name": "Garaja", "isFixed": false },
  "yoga": { "number": 2, "name": "Priti", "sumLongitude": 23.999794 },
  "nakshatra": {
    "number": 24,
    "name": "Shatabhisha",
    "ruler": "Rahu",
    "startDeg": 306.6667,
    "endDeg": 320,
    "pada": 1,
    "longitude": 309.423644
  },
  "rahuKaal": { "name": "Rahu Kaal", "weekdaySlot": 2, "startHour": 7.237123, "endHour": 8.923138, "startTime": "07:14:14", "endTime": "08:55:23" },
  "yamaganda": { "name": "Yamaganda", "weekdaySlot": 4, "startHour": 10.609153, "endHour": 12.295168, "startTime": "10:36:33", "endTime": "12:17:43" },
  "gulika": { "name": "Gulika", "weekdaySlot": 6, "startHour": 13.981183, "endHour": 15.667198, "startTime": "13:58:52", "endTime": "15:40:02" },
  "abhijitMuhurat": { "startHour": 11.845564, "endHour": 12.744772, "midHour": 12.295168, "muhurtaMinutes": 53.952481, "startTime": "11:50:44", "endTime": "12:44:41" }
}

정확도와 출처

정경: Surya Siddhanta (tithi/karana/yoga용), Brihat Samhita (choghadia/muhurta용), Phaladipika (hora용). 진정한 달 계산은 Swiss Ephemeris (DE441/440)를 사용하며, 평균이 아니라 - 이는 tithi 전환에 매우 중요하며 차이가 최대 3시간까지 될 수 있다.
Reference cross-check: drikpanchang.com - 가장 큰 공개 판찬가 소스. 우리의 tithi/nakshatra 전환은 Lahiri ayanamsa 기준으로 drikpanchang과 ±30초 이내로 일치한다.
Choghadia: 7개의 행성 레지던트 고전 순서를 사용한다. 첫 번째 낮 슬롯은 요일 레지던트와 동일(일요일=태양 등).
Rahu Kaal: 일출부터 일몰까지 고정된 1/8 구간, 요일 → 고전 슬롯 번호 매핑(월요일=2번째, 화요일=7번째 등).
관측 지점이 중요하다. Nakshatra와 tithi는 전 세계에서 UTC 기준 동일 시점에 변하지만, 표시 날짜는 시간대에 따라 달라진다. 사용자가 판찬가를 읽고 싶은 위치의 timezoneOffset을 전달해라.