/api/astro/geocode/1 क्रेडिटस्थान खोज
किसी जगह के नाम से वे निर्देशांक और UTC ऑफ़सेट निकालता है, जो दूसरे एंडपॉइंट को चाहिए। `address` क्वेरी पैरामीटर में 'Jaipur, India' जैसा नाम देकर GET भेजें, और आपको `latitude`, `longitude`, IANA `timezone_name`, घंटों में दशमलव संख्या के रूप में `timezone_offset`, जियोकोडर की अपनी `address` स्ट्रिंग और जवाब देने वाला `source` मिलता है। जहाँ सेवा प्रदाता डेलाइट सेविंग बताता है, वहाँ ऑफ़सेट में वह पहले से जुड़ी होती है, इसलिए यह उस जगह का आज का ऑफ़सेट है; ज़रूरी नहीं कि किसी पुरानी जन्म तारीख़ पर भी यही लागू रहा हो। जन्म कुंडली के लिए ये निर्देशांक असली तारीख़ के साथ /api/astro/date_time/ को भेजें, और उस एंडपॉइंट को सही क्षण का ऑफ़सेट तय करने दें। `source` बताता है कि जवाब किस प्रदाता से आया: अगर डिप्लॉयमेंट में Google Maps कुंजी लगी है, तो 'google', वरना 'nominatim', यानी OpenStreetMap की सेवा, जो दूसरे विकल्प के रूप में इस्तेमाल होती है। जगह न मिले, तो 404 मिलता है, और `address` न भेजा जाए, तो 400।
https://api.occultapi.com/api/astro/geocode/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…क्वेरी पैरामीटर (1)
ये URL में भेजे जाते हैं। जिन पर ज़रूरी न लिखा हो, वे सब वैकल्पिक हैं, और इन्हें साथ में इस्तेमाल कर सकते हैं — पहले फ़िल्टर, फिर पेज, फिर क्रम।
| पैरामीटर | टाइप | उदाहरण | क्या करता है | |
|---|---|---|---|---|
| address | string | ज़रूरी | Jaipur, Rajasthan, India | खोजने के लिए शहर/जगह का नाम खोजने के लिए जगह का नाम। कुछ भी लिखा जा सकता है - आम तौर पर शहर का नाम काफ़ी है; एक जैसे नाम वाली जगहों में फ़र्क करने के लिए राज्य या देश भी जोड़ें। |
उदाहरण अनुरोध
curl "https://api.occultapi.com/api/astro/geocode/?address=Jaipur" \
-H "X-API-Key: $OCCULT_API_KEY"उत्तर
{
"address": "Jaipur, Rajasthan, India",
"latitude": 26.9124336,
"longitude": 75.7872709,
"timezone_name": "Asia/Calcutta",
"timezone_offset": 5.5,
"source": "google"
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।