بانشانغ (تقويم هندي)

بانشانغ (पञ्चाङ्ग, “خمسة أعضاء”) - هو تقويم فيديكي ليوم محدد وجغرافية. الخمسة مكونات الأساسية (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: ساعات كوكبية (نسخة فيديكية، تبدأ من شروق الشمس، 24 hora تقريبًا ~1 ساعة لكل واحدة).
• Rahu Kaal: فترة غير مفضلة (1/8 من يوم الضوء، تعتمد على يوم الأسبوع).
• Full panchang: كل ما سبق في طلب واحد (مناسب للـ daily widget).

نقاط النهاية

Endpoint	الائتمانات	ما يعيده
/v1/vedic/panchang/tithi	20	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

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

Node.js

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}`);

Python

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 (لـ tihi/karana/yoga)، Brihat Samhita (لـ choghadia/muhurta)، Phaladipika (لـ hora). الحسابات للقمر الحقيقي باستخدام Swiss Ephemeris (DE441/440)، غير المتوسط - هذا حاسم لانتقالات tithi (الفرق قد يصل إلى 3 ساعات).
• التحقق المرجعي: drikpanchang.com - أكبر مصدر عام للبانشانغ. انتقالات tithi/nakshatra لدينا تتطابق مع drikpanchang ضمن ±30 ثانية لـ Lahiri ayanamsa.
• Choghadia: نستخدم الترتيب الكلاسيكي لـ 7 حكام كوكبيين. الفتحة الأولى من اليوم = حاكم يوم الأسبوع (الأحد - الشمس إلخ).
• Rahu Kaal: فترات ثابتة 1/8 من شروق الشمس إلى غروبها، خريطة يوم الأسبوع → رقم الفتحة حسب الكلاسيكية (الإثنين = الثاني، الثلاثاء = السابع، إلخ).
• نقطة المراقبة لها أهمية. Nakshatra و tithi يتغيران في نفس لحظة UTC في كل مكان - لكن التواريخ المرئية تعتمد على المنطقة الزمنية. أرسل timezoneOffset للمكان الذي يريد المستخدم قراءة البانشانغ منه.

نصيحة

Daily widget pattern. لتطبيق الودجت “البانشانغ اليوم” استدعِ /v1/vedic/panchang/full مرة كل يوم (منتصف الليل حسب توقيت المستخدم) بنفس الإحداثيات. خزن في الذاكرة لمدة 24 ساعة. 20 ائتمان × 30 يوم = 600 ائتمان/شهر للمستخدم - يتناسب مع خطة Indie.

ذات صلة

• داشي: فترات طويلة الأمد (للسنوات/العقود)، البانشانغ - فترات قصيرة (لليوم)
• Shadbala: قوة الكواكب في لحظة البانشانغ
• Варги: مخططات تقسيمية لتحليل أعمق للمورتى
• Точність: اختبارات snapshot للبانشانغ مقابل drikpanchang
• Кредити: جدول كامل للتسعيرات
• Автентифікація: كيف تحصل على مفتاح aw_live_*