डेवलपर API
फ़ॉरवर्ड जियोकोडिंग, रिवर्स जियोकोडिंग, टाइम ज़ोन लुकअप, ऊँचाई और सूरज-चाँद के समय के लिए एक मुफ़्त, दस्तावेज़ीकृत REST API — वही प्राइवेसी का ध्यान रखने वाले प्रॉक्सी जिन पर यह साइट चलती है। कोई क्रेडिट कार्ड नहीं; कुंजी तुरंत बनती है और सिर्फ़ एक बार दिखाई जाती है।
1000 रिक्वेस्ट/दिन · 60 प्रति मिनट
| एंडपॉइंट | यह क्या करता है | उदाहरण |
|---|---|---|
GET /api/v1/geocode | पता / जगह → कोऑर्डिनेट्स (टॉप 5 मैच) | ?q=Eiffel+Tower |
GET /api/v1/reverse-geocode | कोऑर्डिनेट्स → पता | ?lat=48.858&lng=2.294 |
GET /api/v1/timezone | कोऑर्डिनेट्स → IANA टाइम ज़ोन + UTC ऑफ़सेट | ?lat=28.61&lng=77.21 |
GET /api/v1/elevation | कोऑर्डिनेट्स → भू-भाग की ऊँचाई (Copernicus DEM) | ?lat=27.99&lng=86.93 |
GET /api/v1/sun-times | सूर्योदय, सूर्यास्त, भोर, गोधूलि, दिन की लंबाई | ?lat=51.5&lng=-0.12&date=2026-07-19 |
GET /api/v1/moon | चाँद की कला, रोशनी, चंद्रोदय/चंद्रास्त | ?lat=51.5&lng=-0.12 |
प्रमाणीकरण: कुंजी को X-Api-Key हेडर (बेहतर) या ?key= पैरामीटर के रूप में भेजें। हर रिस्पॉन्स में X-RateLimit-Remaining-Today शामिल होता है। एरर JSON में आते हैं, साथ में error कोड। जियोकोडिंग डेटा © OpenStreetMap contributors (ODbL) — बार-बार क्वेरी करने के बजाय नतीजे कैश करें, और एंड-यूज़र ऐप्स में एट्रिब्यूशन दिखाएँ।
# 1. किसी पते का जियोकोड करें
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/geocode?q=Taj+Mahal"
# 2. रिवर्स जियोकोड
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/reverse-geocode?lat=27.1751&lng=78.0421"
# 3. आज के सूर्य समय
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"
उचित उपयोग: मुफ़्त टियर प्रोटोटाइप, एजेंट और छोटे ऐप्स के लिए है। और चाहिए? हमसे बात करें।
यह API इस साइट के टूल्स के लिए स्वीकृत मशीन एंडपॉइंट है (llms.txt और ai.json में भी बताया गया है)। एजेंट भी इसी मुफ़्त टियर पर स्वागत योग्य हैं — साइन अप के उद्देश्य वाले फ़ील्ड में अपने एजेंट की पहचान बताएँ।
पतों (या कोऑर्डिनेट्स) की कोई CSV है? बैच जियोकोडिंग टूल आपकी कुंजी के साथ, आपके ब्राउज़र में ही 500 पंक्तियों तक इस API से चलाता है — करीब 1 रिक्वेस्ट/सेकंड की रफ़्तार से कतार में, नतीजे CSV या GeoJSON में डाउनलोड किए जा सकते हैं, और आपकी फ़ाइल हमारे सर्वर तक कभी नहीं पहुँचती। कुछ हज़ार से ज़्यादा पंक्तियों के काम के लिए मुफ़्त कम्युनिटी जियोकोडर के बजाय कोई कमर्शियल जियोकोडर इस्तेमाल करें।