Geocoding API एक ऐसी सेवा है जो किसी जगह की जानकारी को पते, अक्षांश और देशांतर के निर्देशांक या जगह के आईडी के तौर पर स्वीकार करती है. यह पते को अक्षांश और देशांतर निर्देशांक और जगह के आईडी में बदलता है. इसके अलावा, यह अक्षांश और देशांतर निर्देशांक या जगह के आईडी को पते में बदलता है.
Geocoding API की मदद से क्या-क्या किया जा सकता है
Geocoding API का इस्तेमाल करके, एक या इससे ज़्यादा पतों या जगहों का जियोकोडिंग डेटा पाया जा सकता है. इसमें यह डेटा शामिल है:
- पतों के लिए भौगोलिक निर्देशांक.
- अक्षांश और देशांतर निर्देशांकों के सेट के लिए पते.
- जगह के आईडी के पते.
यह कंट्रोल किया जा सकता है कि नतीजे कहां दिखें. साथ ही, नतीजों को किसी खास इलाके, देश या पिन कोड तक सीमित किया जा सकता है.
Geocoding API के काम करने का तरीका
Geocoding API, जियोकोडिंग और रिवर्स जियोकोडिंग, दोनों करता है:
- जियोकोडिंग: यह "1600 Amphitheatre Parkway, Mountain View, CA" जैसे पतों को अक्षांश और देशांतर निर्देशांक या जगह के आईडी में बदलता है. इन निर्देशांकों का इस्तेमाल करके, मैप पर मार्कर लगाए जा सकते हैं. इसके अलावा, व्यू फ़्रेम में मैप को बीच में या फिर से पोज़िशन किया जा सकता है.
- रिवर्स जियोकोडिंग: यह अक्षांश/देशांतर निर्देशांक या जगह के आईडी को किसी व्यक्ति के लिए आसानी से पढ़े जा सकने वाले पते में बदलता है. पतों का इस्तेमाल कई स्थितियों में किया जा सकता है. जैसे, डिलीवरी या पिकअप के लिए.
इस डेमो में, Maps JavaScript API के ज़रिए Geocoding Service का इस्तेमाल किया गया है, ताकि यह दिखाया जा सके कि Geocoding API कैसे काम करता है. ज़्यादा विकल्प और जानकारी देखने के लिए, मैप को किसी दूसरे टैब में खोलें.
संसाधन
नीचे दी गई टेबल में, Geocoding API के ज़रिए उपलब्ध संसाधनों की खास जानकारी दी गई है. साथ ही, हर तरीके से मिलने वाले डेटा की जानकारी भी दी गई है.
| डेटा रिसॉर्स | डेटा मिला | जवाब का फ़ॉर्मैट |
|---|---|---|
| जियोकोडिंग | यह पता, पते के कॉम्पोनेंट, और पते के टाइप दिखाता है. जियोकोडिंग के अनुरोध और जवाब की गाइड में, नतीजे देखें. |
|
| रिवर्स जियोकोडिंग | यह पता, पते के कॉम्पोनेंट, और पते के टाइप दिखाता है. रिवर्स जियोकोडिंग के अनुरोध और रिस्पॉन्स की गाइड में, रिवर्स जियोकोडिंग के रिस्पॉन्स देखें. | |
| जगह की जियोकोडिंग | यह पता, पते के कॉम्पोनेंट, और पते के टाइप दिखाता है. जगह की जियोकोडिंग के अनुरोध और जवाब की गाइड में, रिवर्स जियोकोडिंग के जवाब देखें. |
Geocoding API को इस्तेमाल करने का तरीका
| 1 | सेट अप करने का तरीका. | Google Cloud प्रोजेक्ट सेट अप करें से शुरू करें और इसके बाद दिए गए सेटअप के निर्देशों को पूरा करें. |
| 2 | जियोकोडिंग का अनुरोध करना | एपीआई पासकोड मिलने के बाद, Geocoding API को सीधे curl या ब्राउज़र से टेस्ट किया जा सकता है. आपको पते या कॉम्पोनेंट लुकअप के लिए, सही लुकअप पैरामीटर देने होंगे. ज़्यादा जानकारी के लिए, जियोकोडिंग पैरामीटर देखें. |
| 3 | रिवर्स जियोकोडिंग का अनुरोध करना | अपने एपीआई पासकोड के साथ अक्षांश/देशांतर निर्देशांक दें, ताकि उस जगह के लिए, किसी व्यक्ति के लिए आसानी से पढ़ा जा सकने वाला सबसे नज़दीकी पता मिल सके. ज़्यादा जानकारी के लिए, रिवर्स जियोकोडिंग के अनुरोध देखें. |
| 4 | जवाबों से जुड़ी बुनियादी बातें समझना | Geocoding API के सभी तरीके, JSON या एक्सएमएल में एक जैसा डेटा दिखाते हैं. डेटा, स्टेटस कोड, और गड़बड़ी के मैसेज के बारे में जानने के लिए, जियोकोडिंग के जवाब देखें. |
| 5 | अपने ऐप्लिकेशन में जियोकोडिंग डेटा शामिल करें! | जियोकोडिंग डेटा का इस्तेमाल करके, मैप मार्कर से पते हासिल किए जा सकते हैं. इसके अलावा, किसी पते के आधार पर मैप पर मार्कर भी लगाए जा सकते हैं. |
उपलब्ध क्लाइंट लाइब्रेरी
इस एपीआई को अपनी पसंद की भाषा में कॉल करने के लिए, इनमें से किसी एक क्लाइंट लाइब्रेरी का इस्तेमाल करें:
- Google Maps की सेवाओं के लिए Java क्लाइंट
- Google Maps की सेवाओं के लिए Python क्लाइंट
- Google Maps की सेवाओं के लिए Go क्लाइंट
- Google Maps की सेवाओं के लिए Node.js क्लाइंट
Google Maps की सेवाओं के लिए Java क्लाइंट, Python क्लाइंट, Go क्लाइंट, और Node.js क्लाइंट, कम्यूनिटी की मदद से काम करने वाली क्लाइंट लाइब्रेरी हैं. इन्हें Apache 2.0 लाइसेंस के तहत ओपन सोर्स किया गया है. इन्हें GitHub से डाउनलोड करें. यहां आपको इंस्टॉल करने के निर्देश और सैंपल कोड भी मिल सकते हैं.
आगे क्या करना है
- Geocoding API का इस्तेमाल शुरू करना: अपना Google Cloud प्रोजेक्ट सेट अप करें पर जाएं.
- अनुरोधों और जवाबों के सैंपल का इस्तेमाल शुरू करना: जियोकोडिंग के अनुरोध और जवाब पर जाएं
- सबसे सही तरीके अपनाएं: पतों को जियोकोड करने के सबसे सही तरीके पर जाएं.