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