/api/astro/eclipse/visibility-path/1 क्रेडिटग्रहण का पथ
सूर्य ग्रहण कहाँ पूर्ण दिखेगा, निर्देशांकों की एक रेखा के रूप में, जिसे आप नक्शे पर बना सकें। यह आपके दिए क्षण के बाद का अगला सूर्य ग्रहण खोजता है, फिर उस बिंदु के नमूने लेता है जहाँ चंद्रमा की छाया की धुरी पृथ्वी से मिलती है, और क्रम से अक्षांश/देशांतर की जोड़ियाँ लौटाता है। 2026-08-12 के पूर्ण ग्रहण का यह पथ साइबेरिया के आर्कटिक से शुरू होकर ध्रुव के ऊपर से गुज़रता है, नीचे आइसलैंड को पार करता है और इबेरिया के पास अटलांटिक में निकल जाता है — यही पथ तय करता है कि किसी जगह पूर्ण ग्रहण दिखेगा या आंशिक। नमूने पूरे ग्रहण के नहीं, केवल पूर्णता (या वलयाकार अवस्था) के समय के लिए जाते हैं। उसके बाहर छाया की धुरी पृथ्वी को छूती ही नहीं और कोई केंद्रीय रेखा नहीं बनती, इसलिए केवल आंशिक ग्रहण पर ऐसी रेखा नहीं बनाई जाती जो है ही नहीं; खाली पथ लौटता है और path_traced_over "none" होता है। जिन बिंदुओं पर धुरी पृथ्वी को नहीं छूती, वे हटा दिए जाते हैं, इसलिए sample_count आपके माँगे नमूनों से कम हो सकता है। साथ में सबसे गहरे ग्रहण वाला बिंदु भी मिलता है, उसके मैग्निट्यूड, आच्छादन, और सारोस श्रृंखला व सदस्य संख्या के साथ — ग्रहण कैटलॉग इसी पहचान से क्रमबद्ध होते हैं। पथ के समय UTC में हैं और उनके अंत में Z लगा है। पथ पूरी पृथ्वी पर फैला होता है, इसलिए बाकी ग्रहण एंडपॉइंट वाला ऑफ़सेट आपसे आधी दुनिया दूर के किसी बिंदु पर भ्रम पैदा करता। प्रच्छाया और उपच्छाया की सीमा-रेखाएँ नहीं लौटाई जातीं: इस गणना में केवल केंद्रीय रेखा निकाली जाती है, और खाली जगहें भेजने का मतलब होता 0N 0E को सीमा बताकर छाप देना।
https://api.occultapi.com/api/astro/eclipse/visibility-path/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| date_time | string (date-time) | ज़रूरी | जिस क्षण की गणना करनी है, ISO 8601 फ़ॉर्मैट में। ऑफ़सेट या अंत में Z हमेशा लगाएँ - बिना ज़ोन वाली वैल्यू UTC नहीं, बल्कि Asia/Kolkata (UTC+05:30) मानी जाती है, और तब 200 के साथ पिछले दिन का नतीजा मिल सकता है। '2026-09-01T06:00:00Z' और '2026-09-01 06:00:00' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं। |
| centrality | string | वैकल्पिक | केंद्रीय का मतलब है कि चंद्रमा की छाया की धुरी सच में पृथ्वी को छूती है। इसका असर तभी होता है, जब eclipse_type 'any' न हो। anycentralnon-central |
| direction | string | वैकल्पिक | date_time से आगे की ओर खोजें या पीछे की ओर। afterbefore |
| eclipse_type | string | वैकल्पिक | खोज को किसी एक तरह के सूर्य ग्रहण तक सीमित करें। anytotalannularpartialhybrid |
| elevation | number (double) | वैकल्पिक | |
| keys | array | वैकल्पिक | कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। |
| latitude | number (double) | वैकल्पिक | स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। |
| longitude | number (double) | वैकल्पिक | स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। |
| samples | integer | वैकल्पिक | पथ पर कितने बिंदु लेने हैं। जितने ज़्यादा, रेखा उतनी चिकनी; अधिकतम 120। min 2 · max 120 |
| timezone_as_float | number (double) | वैकल्पिक | स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। min -12 · max 14 |
उदाहरण अनुरोध
curl -X POST https://api.occultapi.com/api/astro/eclipse/visibility-path/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-01-01T00:00:00+00:00","timezone_as_float":0,"eclipse_type":"total","direction":"after","samples":24}'उत्तर
{
"data": {
"found": true,
"eclipse": {
"type": "total",
"centrality": "central",
"maximum": "2026-08-12T17:45:57Z",
"times": {
"maximum": "2026-08-12T17:45:57Z",
"local_apparent_noon": "2026-08-12T17:03:51Z",
"begin": "2026-08-12T15:34:30Z",
"end": "2026-08-12T19:57:57Z",
"totality_begin": "2026-08-12T16:58:05Z",
"totality_end": "2026-08-12T18:34:00Z",
"centre_line_begin": "2026-08-12T17:00:06Z",
"centre_line_end": "2026-08-12T18:32:01Z"
}
},
"path_traced_over": "totality",
"requested_samples": 24,
"sample_count": 25,
"path": [
{
"datetime_utc": "2026-08-12T16:58:05Z",
"latitude": 74.877805,
"longitude": 117.671955
},
{
"datetime_utc": "2026-08-12T17:02:04Z",
"latitude": 82.361743,
"longitude": 112.418144
},
{
"datetime_utc": "2026-08-12T17:06:04Z",
"latitude": 87.329632,
"longitude": 80.477549
},
{
"datetime_utc": "2026-08-12T17:10:04Z",
"latitude": 86.790315,
"longitude": -2.537547
},
{
"datetime_utc": "2026-08-12T17:14:04Z",
"latitude": 83.870696,
"longitude": -21.42455
},
{
"datetime_utc": "2026-08-12T17:18:03Z",
"latitude": 81.057681,
"longitude": -26.067301
},
{
"datetime_utc": "2026-08-12T17:22:03Z",
"latitude": 78.429119,
"longitude": -27.559629
},
{
"datetime_utc": "2026-08-12T17:26:03Z",
"latitude": 75.963829,
"longitude": -27.916291
},
{
"datetime_utc": "2026-08-12T17:30:03Z",
"latitude": 73.627499,
"longitude": -27.753208
},
{
"datetime_utc": "2026-08-12T17:34:03Z",
"latitude": 71.393131,
"longitude": -27.30956
},
{
"datetime_utc": "2026-08-12T17:38:02Z",
"latitude": 69.248567,
"longitude": -26.695107
},
{
"datetime_utc": "2026-08-12T17:42:02Z",
"latitude": 67.159166,
"longitude": -25.955597
},
{
"datetime_utc": "2026-08-12T17:46:02Z",
"latitude": 65.120178,
"longitude": -25.117197
},
{
"datetime_utc": "2026-08-12T17:50:02Z",
"latitude": 63.119601,
"longitude": -24.188769
},
{
"datetime_utc": "2026-08-12T17:54:02Z",
"latitude": 61.146536,
"longitude": -23.169557
},
{
"datetime_utc": "2026-08-12T17:58:01Z",
"latitude": 59.19864,
"longitude": -22.056292
},
{
"datetime_utc": "2026-08-12T18:02:01Z",
"latitude": 57.248921,
"longitude": -20.82451
},
{
"datetime_utc": "2026-08-12T18:06:01Z",
"latitude": 55.293732,
"longitude": -19.455163
},
{
"datetime_utc": "2026-08-12T18:10:01Z",
"latitude": 53.318925,
"longitude": -17.9132
},
{
"datetime_utc": "2026-08-12T18:14:01Z",
"latitude": 51.305904,
"longitude": -16.145189
},
{
"datetime_utc": "2026-08-12T18:18:00Z",
"latitude": 49.236237,
"longitude": -14.074018
},
{
"datetime_utc": "2026-08-12T18:22:00Z",
"latitude": 47.046663,
"longitude": -11.526755
},
{
"datetime_utc": "2026-08-12T18:26:00Z",
"latitude": 44.648895,
"longitude": -8.169827
},
{
"datetime_utc": "2026-08-12T18:30:00Z",
"latitude": 41.718798,
"longitude": -2.829804
},
{
"datetime_utc": "2026-08-12T18:34:00Z",
"latitude": 37.795826,
"longitude": 4.632462
}
],
"greatest_eclipse": {
"datetime_utc": "2026-08-12T17:45:57Z",
"latitude": 65.162226,
"longitude": -25.135594,
"attributes": {
"solar_diameter_fraction_covered": 1.0177529811525174,
"lunar_to_solar_diameter_ratio": 1.0395246462080372,
"obscuration": 1.0806114900739452,
"core_shadow_diameter_km": -132.45861086856522,
"sun_azimuth": 68.50274145564674,
"sun_true_altitude": 25.738278484149753,
"sun_apparent_altitude": 25.771879784684916,
"moon_elongation": 0.0010572200151275264,
"magnitude_nasa": 1.0395246462080372,
"saros_series": 126,
"saros_member": 48
},
"saros": {
"series": 126,
"member": 48
}
},
"notes": {
"path": "Sampled evenly across totality. Times are UTC.",
"limits": "Umbra and penumbra limits are unavailable: only the central line is computed for this calculation."
}
},
"status": 200,
"is_error": false,
"message": "successful"
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।