स्टार-ग्रहण परान्स API

हर तारे और ग्रह के लिए यह endpoint चार कोणीय घटनाएँ (उदय, अस्त, शिखर, प्रतिशिखर) लेता है और पूछता है कि कौन से अक्षांश पर दोनों एक ही स्थानीय नक्षत्रीय समय में होते हैं। शिखर शरीर की right ascension पर नक्षत्रीय समय को फिक्स करता है; उदय और अस्त इसे अर्द्ध-दिवसीय चाप से बदलते हैं, जो अक्षांश और विचलन का फ़ंक्शन है। बारह घटनाओं के प्रत्येक जोड़े को हल किया जाता है और हर समाधान रिपोर्ट किया जाता है, जिसमें अक्षांश, नक्षत्रीय समय, और वह मेरिडियन शामिल है जहाँ यह जोड़ा उस विशेष चार्ट क्षण में कोणीय है। मेरिडियन बनाम मेरिडियन को अस्वीकार किया जाता है: इस शर्त में कोई अक्षांश नहीं है, इसलिए यह कभी नहीं होता या हर जगह होता है, और हर जगह होना मतलब दोनों का right ascension समान है। जो तारे हल हुए लेकिन कुछ नहीं निकला, उन्हें प्रतिक्रिया में नाम दिया जाता है न कि चुपचाप हटाया जाता है, जैसे कि पोलारिस जैसे सर्कम्पोलर तारे के साथ लगभग पूरे रेंज में होता है।

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 को जन्मस्थान की ज़रूरत नहीं, सिर्फ क्षण चाहिए: कौन से अक्षांश मौजूद हैं यह आकाश की विशेषता है, जन्मस्थान की नहीं।

इसे घंटे के कोणों पर हल किया गया है, न कि मानचित्र के पॉलीलाइन को काटकर, इसलिए अक्षांश सटीक है, पॉलीलाइन स्टेप में क्वांटाइज़ नहीं। तारे का वास्तविक विचलन उपयोग किया जाता है, ज़ोडियाक डिग्री पर प्रोजेक्ट नहीं। यह अंतर महत्वपूर्ण है: वेगा 61 डिग्री इकलिप्टिक अक्षांश पर है और सिरीयस -39 पर, इसलिए उनका डिग्री वह नहीं उठता जब वे होते हैं। तारे की स्थितियाँ Swiss Ephemeris फिक्स्ड-स्टार कैटलॉग से आती हैं, और इकलिप्टिक-से-समतल रूपांतरण को एफ़ेमेरिस खुद के खिलाफ जांचा जाता है ग्रहों को चलाकर। Brady का Castor उदाहरण एक डिग्री के भीतर दोहराया गया है; यह तय नहीं करता कि उन्होंने ज्यामितीय या दृश्य क्षितिज इस्तेमाल किया, और चूँकि दोनों परान अक्षांश में लगभग दो डिग्री अंतर है, यह विकल्प एक request पैरामीटर है, न कि चुपचाप डिफ़ॉल्ट।