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