गणना इंजन
यह API जो भी अंक लौटाता है, वह एफ़ेमेरिस से आता है — किसी तैयार तालिका या मॉडल से नहीं। यहाँ बताया है कि नीचे क्या चल रहा है, और हम किन चीज़ों की गणना नहीं करते।
एफ़ेमेरिस
ग्रहों की स्थिति NASA JPL के ग्रह एफ़ेमेरिस से आती है — वही डेटा जिससे अंतरिक्ष यानों का रास्ता तय होता है। यानी 500–2999 ई. तक की स्थितियों का 105 MB डेटा, और साथ में 735 स्थिर तारे।
यह इसलिए मायने रखता है कि दूसरा रास्ता ऐसा हिसाब है जो अख़बार के कॉलम के लिए तो काफ़ी है, पर कुंडली के लिए नहीं। औसत गति वाले सूत्र सदियों में कई अंश खिसक जाते हैं; 1890 या 2090 के जन्म में यह दिख जाता है, और वर्ग कुंडली में यह थोड़ा अलग नहीं, बिल्कुल दूसरा जवाब बन जाता है। D60 में आधा अंश ही ग्रह को अगले भाग में पहुँचा देता है।
निरयन, और कौन-सा निरयन
वैदिक ज्योतिष निरयन है: स्थितियाँ खिसकते विषुव से नहीं, आकाश के एक स्थिर बिंदु से नापी जाती हैं। दोनों के बीच के अंतर को अयनांश कहते हैं, जो अभी लगभग 24° है, और इसके किसी एक मान पर सब सहमत नहीं हैं।
इसलिए यह एक पैरामीटर है। 48 अयनांश स्वीकार किए जाते हैं — लाहिड़ी, रमन, कृष्णमूर्ति, फ़ेगन-ब्रैडली, युक्तेश्वर, सूर्यसिद्धांत और बाकी। लाहिड़ी डिफ़ॉल्ट है क्योंकि वह भारत सरकार का मानक है, इसलिए नहीं कि वही सही है।
{
"date_time": "1990-08-15T10:30:00+05:30",
"latitude": 26.9124,
"longitude": 75.7873,
"timezone_as_float": 5.5,
"ayanamsa": "KRISHNAMURTI"
}अयनांश पर अलग राय रखने वाले दो ज्योतिषी, दोनों यह API इस्तेमाल करके वही कुंडली पा सकते हैं जिसकी उन्हें उम्मीद है। जो API एक ही अयनांश पक्का कर देता है, वह चुपचाप एक ऐसी बहस में एक पक्ष ले लेता है जो अभी सुलझी नहीं है।
इसमें क्या है
299 एंडपॉइंट, इस हिसाब से समूहों में कि वे क्या गणना करते हैं:
रफ़्तार
सर्वर का मीडियन समय 62 ms है, और 76% एंडपॉइंट 100 ms से कम लेते हैं। यह सभी प्रकाशित उदाहरणों को लोकल चलाकर मापा गया है। एफ़ेमेरिस मेमोरी में मैप रहता है, इसलिए कुंडली का समय डिस्क पर नहीं, गणना पर लगता है।
जहाँ कोई कॉल धीमी है, वहाँ काम सचमुच बड़ा है — गोचर की खोज एक पूरी तारीख़-सीमा छानती है, और PDF रिपोर्ट लगभग पच्चीस एंडपॉइंट को जोड़कर एक दस्तावेज़ बनाती है, फिर भी उसका शुल्क एक ही कॉल का लगता है।
हर बार एक-सा नतीजा
एक ही इनपुट पर हमेशा एक ही आउटपुट मिलता है। बीच में न कोई सैंपलिंग है, न कोई मॉडल, इसलिए आज बनाई कुंडली और अगले साल बनाई वही कुंडली बाइट-दर-बाइट एक जैसी होती हैं। इसी वजह से उत्तर कैश किए जा सकते हैं, और इसी से 1,783 टेस्ट फ़ंक्शन किसी दायरे के बजाय सटीक मान जाँच पाते हैं।
इसका मतलब यह भी है कि किसी मतभेद को जाँचा जा सकता है। अगर हमारा चंद्रमा और आपके सॉफ़्टवेयर का चंद्रमा अलग हैं, तो दोनों में से एक गलत है, और अयनांश या समय क्षेत्र बता देगा कि कौन-सा — ऐसा नहीं कि दोनों “लगभग सही” हों।
हम किसकी गणना नहीं करते
इंजन लगभग हर चीज़ के लिए कोई न कोई अंक निकाल सकता है। पर उनमें से कुछ अंकों का वह मतलब नहीं होता जो पढ़ने वाला समझेगा, और ऐसे एंडपॉइंट हैं ही नहीं।
- लाल किताब के पितृ ऋण। आठों ऋणों के नाम सभी स्रोतों में एक जैसे हैं। पर हर ऋण किन स्थितियों में बनता है, इस पर सहमति नहीं है — अकेले पितृ ऋण के प्रकाशित नियम एक ही कुंडली के लिए अलग-अलग जवाब देते हैं। किसी के पूर्वजों के बारे में ऐसा फ़ैसला हम नहीं सुनाएँगे जो इस पर टिका हो कि हमने संयोग से कौन-सी किताब पढ़ी।
- ऐसे फ़ील्ड जिनका नियम हम किसी स्रोत से तय नहीं कर पाए। जहाँ कोई प्रतिस्पर्धी ऐसा मान लौटाता है जिसे हम किसी स्रोत से साबित नहीं कर सके, वहाँ हमारे उत्तर में वह फ़ील्ड नहीं होता और उत्तर में इसकी वजह लिखी होती है। हम ऐसा भरोसेमंद-सा अंदाज़ा नहीं भेजते जिसे कॉल करने वाला किसी तरह जाँच न सके।
- कुछ भी जो चिकित्सा, क़ानूनी या वित्तीय सलाह के रूप में पेश हो। उपायों वाला पाठ परंपरा से लिया गया है, और उस पर यही लिखा होता है।
जहाँ दो परंपराएँ सचमुच अलग राय रखती हैं और दोनों की अपनी मज़बूत दलील है, वहाँ उत्तर बताता है कि उसने कौन-सी अपनाई — ताकि जवाब को आँख मूँदकर मानना न पड़े, जाँचा जा सके।
आज़माएँ
curl -X POST https://api.occultapi.com/api/astro/planet-positions/ \
-H 'X-API-Key: yt_live_your_key_here' \
-H 'Content-Type: application/json' \
-d '{
"date_time": "1990-08-15T10:30:00+05:30",
"latitude": 26.9124,
"longitude": 75.7873,
"timezone_as_float": 5.5,
"ayanamsa": "LAHIRI"
}'या बिना कोई कोड लिखे इसे प्लेग्राउंड में चलाएँ।