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

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

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 या ब्राउज़र से Geocoding API को टेस्ट किया जा सकता है. आपको पते या कॉम्पोनेंट लुकअप के लिए, सही लुकअप पैरामीटर देने होंगे. ज़्यादा जानकारी के लिए, जियोकोडिंग पैरामीटर देखें.
3 रिवर्स जियोकोडिंग अनुरोध आज़माएं एपीआई पासकोड के साथ अक्षांश/देशांतर कोऑर्डिनेट भी दिखाएं, ताकि उस जगह के पते के कॉम्पोनेंट आसानी से पढ़े जा सकें. ज़्यादा जानकारी के लिए रिवर्स जियोकोडिंग अनुरोध देखें.
4 जवाब देने से जुड़ी बुनियादी बातें समझना Geocoding API के सभी एंडपॉइंट, JSON या एक्सएमएल में एक जैसा डेटा दिखाते हैं. डेटा, स्टेटस कोड, और गड़बड़ी के मैसेज की पूरी जानकारी के लिए, जियोकोडिंग के जवाब देखें.
5 अपने ऐप्लिकेशन में जियोकोडिंग डेटा शामिल करें! मैप मार्कर से पते पाने या किसी मौजूदा पते के आधार पर मैप पर मार्कर उपलब्ध कराने के लिए, जियोकोडिंग डेटा का इस्तेमाल किया जा सकता है.

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

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

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

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