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

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

जियोकोडिंग एपीआई का इस्तेमाल क्यों करें

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

जियोकोडिंग एपीआई की मदद से क्या-क्या किया जा सकता है

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

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

आपके पास यह कंट्रोल करने का विकल्प होता है कि आपके इलाके में खोज के नतीजे कहां दिखेंगे. इसके अलावा, यह भी तय किया जा सकता है कि नतीजों में किसी खास इलाके, देश या पिन कोड का ही इस्तेमाल किया जाए या नहीं.

जियोकोडिंग एपीआई कैसे काम करता है

जियोकोडिंग एपीआई, जियोकोडिंग और रिवर्स जियोकोडिंग, दोनों की सुविधा देता है:

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

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

रिसॉर्स

नीचे दी गई टेबल में, जियोकोडिंग एपीआई और हर एंडपॉइंट के दिए गए डेटा के बारे में जानकारी दी गई है.

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

जियोकोडिंग एपीआई इस्तेमाल करने का तरीका

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

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

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

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

आगे क्या