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

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

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

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

Geocoding API से क्या किया जा सकता है

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

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

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

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

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

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

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

संसाधन

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

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

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

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

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

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

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

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