सौर वापसी एस्ट्रोकार्टोग्राफी API

यह endpoint पहले जन्म चार्ट बनाता है, फिर अनुरोधित वर्ष में वह क्षण खोजता है जब ट्रांसिटिंग सूर्य जन्म सौर लंबाई तक पहुँचता है, सटीकता एक सेकंड के आर्क से बहुत कम। यह उस क्षण के ग्रह स्थितियों की गणना करता है और चार एंगलर लाइन परिवारों को दुनिया भर में ट्रेस करता है, बिल्कुल जन्म एस्ट्रोकार्टोग्राफी endpoint की तरह, कुल मिलाकर तिरसठ (63) लाइनें लौटाता है। हर ग्रह के नाम के साथ SR उपसर्ग होता है ताकि एक साथ दोनों मानचित्र रेंडर करने वाला क्लाइंट जन्म बृहस्पति लाइन को सौर वापसी वाली से भ्रमित न करे। लाइनों को /acg के समान आकार में कोऑर्डिनेट पेयर्स के रूप में लौटाया जाता है, इसलिए मौजूदा renderer को दूसरे लेयर के लिए एक स्टाइल के अलावा कोई बदलाव नहीं चाहिए।

curl -X POST https://api.astroway.info/v1/solar-acg \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52,
  "year": 2026
}'

{
  "ok": true,
  "data": {
    "year": 2026,
    "lines": [
      {
        "planet": "Sun (SR)",
        "planetId": 0,
        "type": "MC",
        "coordinates": [[-85, 110.4845], [-84.5, 110.4845], "…"]
      }
    ]
  }
}

यह endpoint relocation astrology में सबसे अधिक व्यावसायिक सवाल के पीछे है: मैं अपना जन्मदिन कहाँ बिताऊँ, और इस साल मैं कहाँ बेस्ड रहूँ। सौर वापसी चार्ट पारंपरिक रूप से उस स्थान पर बनाए जाते हैं जहाँ व्यक्ति वापसी के समय शारीरिक रूप से होता है, जिससे स्थान एक निर्णय बन जाता है न कि तय चीज़, और यह मानचित्र वही निर्णय उपयोगकर्ता को दिखाने योग्य बनाता है। एक सालाना relocation रिपोर्ट, जन्मदिन-ट्रिप सिफारिशकर्ता, या आपके मौजूदा एस्ट्रोकार्टोग्राफी मानचित्र पर वार्षिक ओवरले बनाओ। क्योंकि मूल वापसी क्षण हर साल बदलता है, परिणाम स्वाभाविक रूप से पुनः-खरीदी योग्य कंटेंट बनता है न कि एक-बार की गणना, और यह /solar-return के साथ सीधे मिलकर काम करता है जब उपयोगकर्ता चार्ट और मानचित्र दोनों चाहता है।

पोजीशन Swiss Ephemeris (Astrodienst) से आती हैं। वापसी क्षण को ट्रॉपिकल ज़ोडियैक में जन्म सौर लंबाई के खिलाफ हल किया जाता है; सिडेरियल सौर वापसी एक अलग तकनीक है और यह endpoint ऐसा नहीं गणना करता। मानचित्र केवल वापसी चार्ट से बनाया जाता है, इसलिए यह उस वर्ष के जन्म लाइनों का पूरा प्रतिस्थापन है, न कि उनका संशोधन। कुछ स्कूल वापसी को जन्मस्थान के बजाय वर्तमान स्थान पर कास्ट करते हैं; यह चुनाव तुम्हारी इंटरप्रिटेशन लेयर पर निर्भर करता है, क्योंकि लाइन जियोमेट्री दोनों ही मामलों में समान रहती है।