जियोकोडिंग एपीआई की खास जानकारी

Geocoding API एक ऐसी सेवा है जो किसी जगह को पते, अक्षांश और देशांतर निर्देशांक या प्लेस आईडी के तौर पर स्वीकार करती है. यह पता को अक्षांश और देशांतर निर्देशांक और प्लेस आईडी में बदलता है. इसके अलावा, अक्षांश और देशांतर निर्देशांक या प्लेस आईडी को पते में बदलता है.

Geocoding API का इस्तेमाल क्यों करना चाहिए

अगर आपको Google Maps Platform के किसी एपीआई से मिले मैप में, जियोकोडिंग डेटा का इस्तेमाल करना है, तो वेबसाइट या मोबाइल ऐप्लिकेशन के लिए Geocoding API का इस्तेमाल करें. Geocoding API की मदद से, मैप पर मार्कर डालने के लिए पतों का इस्तेमाल किया जाता है. इसके अलावा, मैप पर मौजूद मार्कर को पते में बदला जा सकता है. इस सेवा को, मैप पर ऐप्लिकेशन कॉन्टेंट को दिखाने के लिए, पहले से तय किए गए स्टैटिक पतों को जियोकोड करने के लिए डिज़ाइन किया गया है.

Geocoding API का इस्तेमाल करके क्या-क्या किया जा सकता है

एक या उससे ज़्यादा पतों या जगहों के लिए जियोकोडिंग डेटा पाने के लिए, Geocoding API का इस्तेमाल किया जा सकता है. इनमें ये शामिल हैं:

  • पतों के लिए भौगोलिक निर्देशांक.
  • अक्षांश और देशांतर के निर्देशांक के सेट के पते.
  • जगह के आईडी के लिए पते.

यह कंट्रोल किया जा सकता है कि नतीजे कहां दिखें. साथ ही, नतीजों को किसी खास इलाके, देश या पिन कोड तक सीमित किया जा सकता है.

Geocoding API के काम करने का तरीका

Geocoding API, जियोकोडिंग और रिवर्स जियोकोडिंग, दोनों करता है:

  • जियोकोडिंग: "1600 Amphitheatre Parkway, Mountain View, CA" जैसे पतों को अक्षांश और देशांतर निर्देशांक या जगह के आईडी में बदलता है. इन निर्देशांक का इस्तेमाल, मैप पर मार्कर डालने या व्यू फ़्रेम में मैप को केंद्र में या फिर किसी दूसरी जगह पर ले जाने के लिए किया जा सकता है.
  • रिवर्स जियोकोडिंग: अक्षांश/देशांतर निर्देशांक या प्लेस आईडी को ऐसे पते में बदलता है जिसे कोई भी पढ़ सकता है. पतों का इस्तेमाल कई कामों के लिए किया जा सकता है. जैसे, डिलीवरी या पिकअप के लिए.

इस डेमो में, Maps JavaScript API के ज़रिए जियोकोडिंग सेवा का इस्तेमाल किया गया है. इससे यह पता चलता है कि जियोकोडिंग एपीआई कैसे काम करता है. ज़्यादा विकल्प और जानकारी देखने के लिए, मैप को अलग टैब में खोलें.

संसाधन

नीचे दी गई टेबल में, Geocoding API के ज़रिए उपलब्ध संसाधनों के बारे में खास जानकारी दी गई है. साथ ही, हर एंडपॉइंट से मिलने वाले डेटा के बारे में भी बताया गया है.

डेटा संसाधन डेटा वापस पाना रिटर्न का फ़ॉर्मैट
जियोकोडिंग यह पता, पते के कॉम्पोनेंट, और पते के टाइप दिखाता है. जियोकोडिंग के अनुरोध और जवाब से जुड़ी गाइड में, नतीजे देखें.
  • JSON
  • XML
रिवर्स जियोकोडिंग यह फ़ंक्शन, पता, पते के कॉम्पोनेंट, और पते के टाइप दिखाता है. रिवर्स जियोकोडिंग के अनुरोध और जवाब की गाइड में, रिवर्स जियोकोडिंग के जवाब देखें.
जगह की जानकारी को जियोकोड करना यह फ़ंक्शन, पता, पते के कॉम्पोनेंट, और पते के टाइप दिखाता है. जगह की जानकारी जियोकोड करने के अनुरोध और जवाब से जुड़ी गाइड में, जगह की जानकारी रिवर्स जियोकोड करने के जवाब देखें.

Geocoding API का इस्तेमाल करने का तरीका

1 सेट अप करें. अपना Google Cloud प्रोजेक्ट सेट अप करें से शुरू करें और इसके बाद दिए गए सेटअप निर्देशों को पूरा करें.
2 जियोकोडिंग का अनुरोध करें एपीआई पासकोड मिलने के बाद, सीधे curl या ब्राउज़र से, जियोकोडिंग एपीआई की जांच शुरू की जा सकती है. आपको पते या कॉम्पोनेंट के लुकअप के लिए, सही लुकअप पैरामीटर देने होंगे. ज़्यादा जानकारी के लिए, जियोकोडिंग पैरामीटर देखें.
3 पता बदलने के लिए अनुरोध करें एपीआई पासकोड के साथ अक्षांश/देशांतर के निर्देशांक दें, ताकि उस जगह के लिए, मनुष्य के पढ़ने लायक सबसे करीबी पते के लिए पते के कॉम्पोनेंट हासिल किए जा सकें. ज़्यादा जानकारी के लिए, रीवर्स जियोकोडिंग के अनुरोध देखें.
4 जवाब से जुड़ी बुनियादी बातें समझना Geocoding API के सभी एंडपॉइंट, JSON या एक्सएमएल में एक ही डेटा दिखाते हैं. डेटा, स्टेटस कोड, और गड़बड़ी के मैसेज के बारे में जानकारी पाने के लिए, जियोकोडिंग के जवाब देखें.
5 अपने ऐप्लिकेशन में जियोकोडिंग डेटा शामिल करें! जियोकोडिंग डेटा का इस्तेमाल करके, मैप मार्कर से पते पाएं या किसी पते के आधार पर मैप पर मार्कर डालें.

उपलब्ध क्लाइंट लाइब्रेरी

इस एपीआई को अपनी पसंद की भाषा में कॉल करने के लिए, इनमें से किसी एक क्लाइंट लाइब्रेरी का इस्तेमाल करें:

Google Maps Services के लिए Java क्लाइंट, Python क्लाइंट, Go क्लाइंट, और Node.js क्लाइंट, कम्यूनिटी के साथ काम करने वाली क्लाइंट लाइब्रेरी हैं. ये Apache 2.0 लाइसेंस के तहत ओपन सोर्स हैं. उन्हें GitHub से डाउनलोड करें. यहां आपको इंस्टॉल करने के निर्देश और सैंपल कोड भी मिल सकते हैं.

आगे क्या करना है