पते को कोड में बदलने का तरीका, पते (जैसे कि मोहल्ले का पता) को भौगोलिक निर्देशांक (अक्षांश और देशांतर) में बदलने की प्रक्रिया है. इसका इस्तेमाल करके, मैप पर मार्कर डाले जा सकते हैं या मैप को पोज़िशन किया जा सकता है. इस दस्तावेज़ में खास तौर पर, पतों को कोड करते समय शामिल की गई बातों के बारे में साफ़ तौर पर बताया गया है. यह बताता है कि जियोकोडिंग एपीआई का इस्तेमाल कब करना सबसे सही है. साथ ही, यह भी बताएं कि कब प्लेसी एपीआई प्लेस ऑटोकंप्लीट सेवा का इस्तेमाल करना फ़ायदेमंद होता है.
आम तौर पर, पूरे पते पते (उदाहरण के लिए, “48 Pirrama Rd, Pyrmont, NSW, Australia]) को कोड में बदलते समय, जियोकोडिंग एपीआई का इस्तेमाल करें. अस्पष्ट और अधूरे ऐप्लिकेशन के लिए जगह की जानकारी का इस्तेमाल करते समय, जगहों के एपीआई का अपने-आप पूरा होने वाली सेवा का इस्तेमाल करें. जैसे, उपयोगकर्ता के इनपुट का जवाब देते समय.
एपीआई के इस्तेमाल के उदाहरण और सुझाव
| एपीआई के इस्तेमाल के उदाहरण और सुझाव | |
|---|---|
| उपयोगकर्ता के इनपुट का जवाब, रीयल टाइम में दें (जिसमें उपयोगकर्ता की तरफ़ से डाले गए ऐसे पते शामिल हों जो साफ़ तौर पर समझ न आए हों, गलत हों या गलत तरीके से लिखे गए हों) | प्लेस आईडी पाने के लिए 'जगहों के एपीआई' प्लेस की ऑटोकंप्लीट सुविधा का इस्तेमाल करें. फिर, जगह के आईडी को अक्षांश में बदलने के लिए जियोकोडिंग एपीआई का इस्तेमाल करें. |
| अपने-आप काम करने वाले सिस्टम प्रोसेस हो रहे हैं, साफ़ तौर पर पता नहीं दिए गए हैं (उदाहरण के लिए, “48 Pirrama Rd, Pyrmont, NSW, Australia”) | जियोकोडिंग एपीआई वेब सेवा का इस्तेमाल करें. |
| अपने-आप काम करने वाले सिस्टम, किसी संदिग्ध क्वेरी को प्रोसेस कर रहे हैं (उदाहरण के लिए, अधूरा, गलत फ़ॉर्मैट किया गया या गलत लिखा गया पता) | जियोकोडिंग एपीआई के वेब सेवा का इस्तेमाल करने का सुझाव दें. हालांकि, ऐसे ऑटोमेटेड सिस्टम (कार्रवाइयों को अपने-आप पूरा करने वाले सिस्टम) जिनसे उपयोगकर्ताओं के इनपुट से बहुत ज़्यादा, अधूरी या गलत स्पेलिंग वाली क्वेरी मिलती हैं, इंटरैक्टिव इंटरैक्टिव ऑटोकंप्लीट विजेट जोड़ने का फ़ायदा मिल सकता है. इससे, उपयोगकर्ताओं को कोई नतीजा चुनने और पते की गलत स्पेलिंग से बचने में मदद मिलती है. |
| निर्देश वाली स्ट्रिंग या डिस्टेंस मैट्रिक्स एपीआई का इस्तेमाल करके, इंतज़ार की समस्या | Places आईडी पाने के लिए, Places API ऑटोकंप्लीट सुविधा का इस्तेमाल करके, जियोकोडिंग के इंतज़ार का समय कम करें. इसके बाद, निर्देश एपीआई या डिस्टेंस मैट्रिक्स एपीआई में प्लेस आईडी पास करें. |
उपयोगकर्ता के इनपुट का जवाब दिया जा रहा है
उपयोगकर्ता इनपुट की मदद से, रीयल टाइम में जवाब देने वाले ऐप्लिकेशन के लिए दो अहम बातों का ध्यान रखा जाता है, जो एपीआई के विकल्प पर असर डालती हैं:
- आम तौर पर, उपयोगकर्ता का इनपुट, प्रोग्रेस के तौर पर दिया गया पता (जैसे कि “123 मेन स्ट्रीट”) डालना होता है. इसलिए, अधूरे, अस्पष्ट पतों को भौगोलिक जगह पर रखने से फ़ायदा होता है, क्योंकि इससे उपयोगकर्ता को तेज़ी से नतीजा मिलता है.
- उपयोगकर्ता इनपुट का जवाब देने वाले ऐप्लिकेशन के इंतज़ार का समय बहुत ज़्यादा होता है.
ये दोनों बातें, एपीआई में जगह की जानकारी अपने-आप भरने की सुविधा को उपयोगकर्ता के इनपुट का जवाब देने के उदाहरण के तौर पर इस्तेमाल करती हैं. Place ऑटोकंप्लीट की सुविधा को इस तरह डिज़ाइन किया गया है कि यह उपयोगकर्ताओं को एक से ज़्यादा विकल्प दे सके और उनमें से कोई एक विकल्प चुन सके. कारोबारों को बाहर रखते हुए, जगह की जानकारी के एपीआई को सिर्फ़ भौगोलिक पते या पते खोजने पर पाबंदी लगाई जा सकती है. इसके अलावा, ऑटोकंप्लीट लुकअप फ़ंक्शन की मदद से, किसी जगह से जुड़े खास नतीजे दिखाए जा सकते हैं. Places API जगह का आईडी दिखाता है. इसे जियोकोडिंग एपीआई वेब सेवा के ऐसे पते के तौर पर पास किया जाता है जिसकी पूरी जानकारी नहीं दी जाती. इसके बाद, यह पते की पूरी जानकारी दिखाता है और पते को अक्षांश में बदलता है. जगहों के आईडी, दूसरे एपीआई पर भी भेजे जा सकते हैं. जैसे, निर्देश से जुड़े एपीआई और डिस्टेंस मैट्रिक्स एपीआई (नीचे देखें).
जियोकोडिंग एपीआई में पते को कोड करने में बहुत ज़्यादा समय लगता है. साथ ही, यह अधूरी या अस्पष्ट क्वेरी के लिए कम सटीक नतीजे देता है, इसलिए ऐसे ऐप्लिकेशन के लिए इसका सुझाव नहीं दिया जाता जिनका जवाब उपयोगकर्ता को रीयल-टाइम में देना होता है.
Android, iOS, JavaScript, और Places API के लिए, जगह की जानकारी अपने-आप पूरी होने की सुविधा के बारे में ज़्यादा जानकारी पाएं.
ऑटोमेटेड सिस्टम (कार्रवाइयों को अपने-आप पूरा करने वाले सिस्टम)
अपने-आप होने वाले सिस्टम की प्रोसेसिंग पूरी है, साफ़ तौर पर नहीं दी गई है, और डाक पते की जानकारी दी गई है: पूरी तरह से सटीक जानकारी देने वाली क्वेरी, जैसे कि पूरे डाक पते वाली स्ट्रिंग (जैसे, “48 Pirrama Rd, Pyrmont, NSW, Australia”), जियोकोडिंग एपीआई वेब सेवा से सबसे सही तरीके से मैनेज की जाती है. पते को कोड करने के बैकएंड से, दुनिया भर में वेब पतों का ज़्यादा कवरेज मिलता है. साथ ही, इस तरह की पूरी और संदिग्ध क्वेरी के साथ, अच्छी क्वालिटी के नतीजे पाने के लिए ऑप्टिमाइज़ किया जाता है.
अपने-आप काम करने वाले सिस्टम की ऐसी क्वेरी जो समझ में नहीं आती हैं: ऐसी क्वेरी जिनमें अस्पष्ट फ़ॉर्मैट वाले पते होते हैं और जिनमें अधूरे पते या वर्तनी की गलतियां होती हैं. अपने-आप काम करने वाले सिस्टम के लिए, हम आपको जियोकोडिंग एपीआई वेब सेवा इस्तेमाल करने का सुझाव देते हैं. हालांकि, जियोकोडिंग एपीआई को ऐसी किसी क्वेरी का जवाब देने के लिए नहीं बनाया गया है जिसके बारे में साफ़ तौर पर पता न हो. साथ ही, अस्पष्ट क्वेरी के जवाब में, शून्य या ज़्यादा सटीक नतीजे नहीं मिल सकते. अगर आपका ऑटोमेटेड सिस्टम, उपयोगकर्ता के इनपुट से साफ़ तौर पर बड़ी संख्या में यह प्रोसेस करता है, तो आपको जगहों के एपीआई में अपने-आप जानकारी भरने की सेवा का इस्तेमाल करके, अपने ऐप्लिकेशन में एक इंटरैक्टिव एलिमेंट जोड़ने से फ़ायदा मिल सकता है. ऐसा इसलिए किया जाता है, क्योंकि यह कई विकल्पों को दिखाने और उपयोगकर्ता को उनके बीच चुनने की अनुमति देने के लिए डिज़ाइन किया गया है. Places API जगह का आईडी दिखाता है. इसे जियोकोडिंग एपीआई वेब सेवा के तौर पर पूरी तरह से दिखाया जा सकता है. यह पते की पूरी जानकारी देता है और पते को अक्षांश में बदलता है. Android, iOS, JavaScript, और Places API के लिए, जगह की जानकारी अपने-आप पूरी होने की सुविधा के बारे में ज़्यादा जानकारी पाएं.
निर्देश से जुड़े एपीआई के लिए इंतज़ार का समय कम करना और डिस्टेंस मैट्रिक्स एपीआई
जब ऑरिजिन, डेस्टिनेशन या वेपॉइंट को पते की स्ट्रिंग के तौर पर बताया जाता है, तो इन दिशा-निर्देशों का हिसाब लगाने से पहले निर्देशों के एपीआई और डिस्टेंस मैट्रिक्स एपीआई उसी बैकएंड का इस्तेमाल करते हैं जिसका इस्तेमाल जियोकोडिंग एपीआई में किया जा रहा था. इससे अक्षांश और जगह के आईडी जैसी जगहों के बारे में बताने के मुकाबले, इंतज़ार के समय में काफ़ी बढ़ोतरी होती है.
अगर आपका ऐप्लिकेशन उपयोगकर्ता के इनपुट के जवाब में, निर्देश देने के एपीआई या डिस्टेंस मैट्रिक्स एपीआई के इस्तेमाल में देरी की स्थिति में होता है, तो हमारा सुझाव है कि आप लोकेशन स्ट्रिंग के लिए प्लेस स्ट्रिंग के अपने-आप पूरा होने की सेवा का इस्तेमाल करके जगह की जानकारी के आईडी को जगह की जानकारी वाले आईडी में बदलें. इसके बाद, जगह की जानकारी के एपीआई को जगह की जानकारी वाले एपीआई पर भेजें. Android, iOS, JavaScript, और Places API पर, प्लेस ऑटोकंप्लीट सुविधा के बारे में ज़्यादा जानकारी पाएं. जगह की जानकारी के अपने-आप पूरा होने और निर्देश पाने के लिए JavaScript का उदाहरण भी देखें.
नतीजा
आपके उपयोग के उदाहरण के हिसाब से, पते की पहचान करने के लिए, जियोकोडिंग एपीआई का इस्तेमाल करके या 'जियोकोडिंग एपीआई' के साथ 'जगह अपने-आप पूरी होने की सुविधा' सेवा का इस्तेमाल करके, आप ऐसे ऐप्लिकेशन बना सकते हैं जो उपयोगकर्ताओं को सही जियोकोडिंग के नतीजे दिखाते हैं. साथ ही, इंतज़ार के समय को कम करते हैं.
गड़बड़ियों और बार-बार किए जाने वाले उपायों को मैनेज करना
अगर आपको UNKNOWN_ERROR जवाब मिलता है, तो ये समस्याएं थोड़े समय के लिए होती हैं और कुछ समय बाद फिर से कोशिश करने पर ये सबसे अच्छे तरीके से समस्या ठीक हो जाती हैं. हम Google Maps Platform की वेब सेवाओं क्लाइंट लाइब्रेरी का इस्तेमाल करने का सुझाव देते हैं, जिनमें फिर से कोशिश करने का तर्क शामिल होता है. साथ ही, हम Google Maps Platform की प्रीमियम प्लान की पुष्टि करने की सुविधा भी देते हैं.
Java Client,
Python क्लाइंट,
Go Client,
और Node.js Client
Google Maps की सेवाओं के लिए कम्यूनिटी लाइब्रेरी का इस्तेमाल करते हैं.
ये लाइब्रेरी GitHub पर डाउनलोड और योगदान के लिए उपलब्ध होती हैं. यहां आपको इंस्टॉल करने के निर्देश और
सैंपल कोड भी मिलेंगे.
अगर आपको रिस्पॉन्स के तौर पर OVER_QUERY_LIMIT स्टेटस कोड मिलता है, तो इसका मतलब है कि आप एपीआई के
इस्तेमाल की सीमा पार कर चुके हैं. हमारा सुझाव है कि आप
ऑप्टिमाइज़ेशन के इन तरीकों का इस्तेमाल करें.