Geocoding API v4 के तरीकों के लिए, डिफ़ॉल्ट कोटा 25 क्वेरी प्रति सेकंड (क्यूपीएस) है. अनुरोध भेजने की सीमा बढ़ाने का अनुरोध करने के बारे में जानकारी पाने के लिए, अनुरोध भेजने की सीमा देखना और मैनेज करना लेख पढ़ें. इसके बाद, सेवा के तौर पर Geocoding API चुनें.

Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

जियोकोडिंग, पतों (जैसे, मोहल्ले का पता) को भौगोलिक निर्देशांकों (अक्षांश और देशांतर) में बदलने की प्रोसेस है. इनका इस्तेमाल, मैप पर मार्कर लगाने या मैप की पोज़िशन तय करने के लिए किया जा सकता है. इस दस्तावेज़ का मकसद, पतों को जियोकोड करते समय ध्यान में रखी जाने वाली बातों के बारे में बताना है. इसमें बताया गया है कि Geocoding API का इस्तेमाल करना कब सही होता है और Places API की, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा का इस्तेमाल करना कब फ़ायदेमंद होता है.

आम तौर पर, पूरे पतों को जियोकोड करते समय Geocoding API का इस्तेमाल करें. उदाहरण के लिए, "48 Pirrama Rd, Pyrmont, NSW, Australia". अधूरे पतों की जियोकोडिंग करते समय या इंतज़ार के समय के हिसाब से संवेदनशील ऐप्लिकेशन के लिए, Places API की किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा का इस्तेमाल करें. जैसे, उपयोगकर्ता के इनपुट का जवाब देते समय.

इस्तेमाल के उदाहरण और एपीआई के सुझाव

इस्तेमाल के उदाहरण और एपीआई के सुझाव
मंज़िल पर पहुंचना, मंज़िल चुनने की बेहतर सुविधा, आखिरी छोर तक डिलीवरी, राइडशेयर पिकअप/ड्रॉपऑफ़, इमारत के प्रवेश द्वार या कैंपस नेविगेशन	Geocoding API v4 में Search for destinations (`SearchDestinations`) तरीके का इस्तेमाल करके, बिल्डिंग के एंट्री पॉइंट, रूट किए जा सकने वाले नेविगेशन पॉइंट, बिल्डिंग की आउटलाइन, और आस-पास की लोकप्रिय जगहों की जानकारी पाएं. जियोकोडिंग का तरीका चुनना देखें.
उपयोगकर्ता के इनपुट का रीयल टाइम में जवाब देना (इसमें उपयोगकर्ता के डाले गए ऐसे पते शामिल हैं जो साफ़ तौर पर समझ नहीं आते, अधूरे हैं, गलत तरीके से फ़ॉर्मैट किए गए हैं या जिनकी स्पेलिंग गलत है)	जगह का आईडी पाने के लिए, Places API की Place Autocomplete सेवा का इस्तेमाल करें. इसके बाद, `SearchDestinations` (हाइपरलोकल जानकारी के लिए) या `GeocodePlace` (बुनियादी निर्देशांकों के लिए) को कॉल करें.
ऑटोमेटेड सिस्टम (कार्रवाइयों को अपने-आप पूरा करने वाले सिस्टम), डाक पते की पूरी और साफ़ जानकारी को प्रोसेस करते हैं (उदाहरण के लिए, “48 Pirrama Rd, Pyrmont, NSW, Australia”)	Geocoding API v4 वेब सेवा का इस्तेमाल करें. हाइपरलोकल जानकारी के लिए `SearchDestinations` या निर्देशांक लुकअप के लिए `GeocodeAddress` का इस्तेमाल करें.
अस्पष्ट क्वेरी को प्रोसेस करने वाले ऑटोमेटेड सिस्टम (कार्रवाइयों को अपने-आप पूरा करने वाले सिस्टम) (उदाहरण के लिए, अधूरे, गलत फ़ॉर्मैट वाले या गलत स्पेलिंग वाले पते)	हमारा सुझाव है कि ऑटोमेटेड सिस्टम (कार्रवाइयों को अपने-आप पूरा करने वाला सिस्टम), Geocoding API वेब सेवा का इस्तेमाल करें. हालांकि, उपयोगकर्ता के इनपुट से मिली क्वेरी में, गलत वर्तनी, अधूरी या साफ़ तौर पर न दी गई जानकारी की दर ज़्यादा होने पर, ऑटोमेटेड सिस्टम (कार्रवाइयों को अपने-आप पूरा करने वाले सिस्टम) को इंटरैक्टिव प्लेस ऑटोकंप्लीट विजेट जोड़ने से फ़ायदा मिल सकता है. इससे उपयोगकर्ता, नतीजे चुन सकते हैं और पते की गलत वर्तनी से बच सकते हैं.
देरी से जुड़ी समस्याएं: Directions API (लेगसी) या Distance Matrix API (लेगसी) का इस्तेमाल करने पर, शुरुआती जगहों, मंज़िलों या वेपॉइंट को पते की स्ट्रिंग के तौर पर बताने पर, देरी से जुड़ी समस्याएं आ सकती हैं	जगह के आईडी पाने के लिए, Places API की किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा का इस्तेमाल करके, जियोकोडिंग के इंतज़ार का समय कम करें. इसके बाद, जगह के आईडी को Directions API (लेगसी) या Distance Matrix API (लेगसी) को पास करें.

उपयोगकर्ता के इनपुट का जवाब देना

उपयोगकर्ता के इनपुट पर रीयल-टाइम में जवाब देने वाले ऐप्लिकेशन के लिए, दो मुख्य बातों का ध्यान रखना ज़रूरी है. इनसे एपीआई के विकल्प पर असर पड़ता है:

उपयोगकर्ता के इनपुट में आम तौर पर, पते को धीरे-धीरे डालना शामिल होता है. जैसे, "123 मेन स्ट्रीट". इसलिए, अधूरे और साफ़ तौर पर न बताए गए पतों को जियोकोड करने की सुविधा काफ़ी फ़ायदेमंद होती है. इससे उपयोगकर्ता को तेज़ी से नतीजा मिलता है.
उपयोगकर्ता के इनपुट का जवाब देने वाले ऐप्लिकेशन, इंतज़ार के समय के हिसाब से काफ़ी संवेदनशील होते हैं.

इन दो बातों की वजह से, Places API में किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा, उपयोगकर्ता के इनपुट का जवाब देने के लिए सबसे सही है. किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा को इस तरह डिज़ाइन किया गया है कि यह कई संभावित विकल्प दिखाती है. साथ ही, उपयोगकर्ता को उनमें से कोई एक विकल्प चुनने की अनुमति देती है. Places API को सिर्फ़ जियोकोड या पते खोजने के लिए सीमित किया जा सकता है. ऐसा करने पर, कारोबारों की जानकारी नहीं खोजी जा सकेगी. इसके अलावा, ऑटोकंप्लीट लुकअप फ़ंक्शन, किसी जगह के हिसाब से नतीजे दिखाने के लिए पक्षपात कर सकता है. Places API, जगह का आईडी दिखाता है. इसे Geocoding API वेब सेवा को पूरी तरह से साफ़ तौर पर बताई गई जगह के तौर पर पास किया जा सकता है. इसके बाद, यह सेवा पते की पूरी जानकारी दिखाती है और पते को अक्षांश और देशांतर में जियोकोड करती है. जगह के आईडी, अन्य एपीआई को भी पास किए जा सकते हैं. जैसे, Directions API (लेगसी) और Distance Matrix API (लेगसी). ज़्यादा जानकारी के लिए, लेटेंसी कम करना लेख पढ़ें.

Geocoding API में पते की जियोकोडिंग में इंतज़ार का समय ज़्यादा होता है. साथ ही, अधूरी या साफ़ तौर पर न दी गई क्वेरी के लिए, कम सटीक नतीजे मिलते हैं. इसलिए, इसे ऐसे ऐप्लिकेशन के लिए इस्तेमाल करने का सुझाव नहीं दिया जाता है जिन्हें उपयोगकर्ता के इनपुट का जवाब रीयल टाइम में देना होता है.

Android, iOS, JavaScript, और Places API के लिए, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा के बारे में ज़्यादा जानकारी पाएं.

ऑटोमेटेड सिस्टम (कार्रवाइयों को अपने-आप पूरा करने वाले सिस्टम)

ऑटोमेटेड सिस्टम (कार्रवाइयों को अपने-आप पूरा करने वाला सिस्टम), डाक पते की पूरी और साफ़ जानकारी को प्रोसेस करता है: डाक पते की पूरी जानकारी वाली स्ट्रिंग (उदाहरण के लिए, "48 Pirrama Rd, Pyrmont, NSW, Australia") जैसी साफ़ क्वेरी को Geocoding API वेब सेवा सबसे बेहतर तरीके से हैंडल करती है. बैकएंड पर पते को जियोकोड करने की सुविधा, दुनिया भर में ज़्यादा पतों को कवर करती है. साथ ही, इसे इस तरह की पूरी और साफ़ क्वेरी के लिए, अच्छी क्वालिटी के नतीजे देने के लिए ऑप्टिमाइज़ किया गया है.

अस्पष्ट क्वेरी को प्रोसेस करने वाला ऑटोमेटेड सिस्टम (कार्रवाइयों को अपने-आप पूरा करने वाला सिस्टम): अस्पष्ट क्वेरी वे होती हैं जिनमें गलत तरीके से फ़ॉर्मैट किए गए पते, अधूरे पते या स्पेलिंग की गलतियां होती हैं. ऑटोमेटेड सिस्टम (कार्रवाइयों को अपने-आप पूरा करने वाला सिस्टम) के लिए, हम Geocoding API वेब सेवा का इस्तेमाल करने का सुझाव देते हैं. हालांकि, Geocoding API को ऐसी क्वेरी के लिए डिज़ाइन नहीं किया गया है जिनमें साफ़ तौर पर जानकारी न दी गई हो. इसलिए, ऐसी क्वेरी के लिए, यह कम सटीक नतीजे या कोई नतीजा नहीं दिखा सकता. अगर आपका ऑटोमेटेड सिस्टम (कार्रवाइयों को अपने-आप पूरा करने वाला सिस्टम), उपयोगकर्ता के इनपुट से मिली ऐसी क्वेरी को प्रोसेस करता है जो साफ़ तौर पर समझ नहीं आती हैं, तो आपको अपने ऐप्लिकेशन में इंटरैक्टिव एलिमेंट जोड़ने से फ़ायदा मिल सकता है. इसके लिए, Places API में मौजूद, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा का इस्तेमाल करें. इसे कई संभावित विकल्प दिखाने और उपयोगकर्ता को उनमें से चुनने की अनुमति देने के लिए डिज़ाइन किया गया है. Places API, जगह का आईडी दिखाता है. इसे Geocoding API वेब सेवा को पूरी तरह से साफ़ तौर पर बताई गई जगह के तौर पर पास किया जा सकता है. इसके बाद, यह सेवा पते की पूरी जानकारी दिखाती है और पते को अक्षांश और देशांतर में जियोकोड करती है. Android, iOS, JavaScript, और Places API के लिए, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा के बारे में ज़्यादा जानकारी पाएं.

Directions API (लेगसी) और Distance Matrix API (लेगसी) के लिए, इंतज़ार का समय कम करना

जब शुरुआत की जगह, मंज़िल या रास्ते के पड़ाव को पते की स्ट्रिंग के तौर पर बताया जाता है, तो Directions API (लेगसी) और Distance Matrix API (लेगसी), Geocoding API की तरह ही बैकएंड का इस्तेमाल करते हैं. ऐसा, रास्ते की जानकारी देने से पहले इन पतों को जियोकोड करने के लिए किया जाता है. इससे, जगहों को अक्षांश और देशांतर या जगह के आईडी के तौर पर बताने के मुकाबले, इंतज़ार का समय काफ़ी बढ़ जाता है.

अगर आपका ऐप्लिकेशन, उपयोगकर्ता के इनपुट का जवाब देने जैसी इंतज़ार के समय के हिसाब से संवेदनशील स्थिति में, Directions API (लेगसी) या Distance Matrix API (लेगसी) का इस्तेमाल करता है और आपकी शुरुआत की जगह, मंज़िल या वेपॉइंट को शुरुआत में पते की स्ट्रिंग के तौर पर बताया गया है, तो हमारा सुझाव है कि आप Places API की किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा का इस्तेमाल करके, इंतज़ार के समय को कम करें. इससे पते की स्ट्रिंग को जगह के आईडी में बदला जा सकता है. इसके बाद, जगह के आईडी को Directions API (लेगसी) या Distance Matrix API (लेगसी) में पास करें. Android, iOS, JavaScript, और Places API के लिए, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा के बारे में ज़्यादा जानकारी पाएं. किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा और निर्देशों का JavaScript उदाहरण भी देखें.

नतीजा

अपने इस्तेमाल के उदाहरण के आधार पर, Geocoding API का इस्तेमाल अकेले किया जा सकता है या इसे किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सेवा के साथ जोड़ा जा सकता है. इससे आपको ऐसे ऐप्लिकेशन बनाने में मदद मिलती है जो सटीक जियोकोडिंग नतीजे देते हैं और इंतज़ार का समय कम करते हैं.

गड़बड़ियां और फिर से कोशिश करने की प्रोसेस मैनेज करना

अगर आपको UNKNOWN_ERROR रिस्पॉन्स मिलते हैं, तो ये कुछ समय के लिए होने वाली गड़बड़ियों की वजह से होते हैं. इनसे निपटने का सबसे अच्छा तरीका यह है कि कुछ देर बाद फिर से कोशिश करें. हमारा सुझाव है कि आप Google Maps Platform की वेब सेवाओं की क्लाइंट लाइब्रेरी का इस्तेमाल करें. इनमें फिर से कोशिश करने का लॉजिक शामिल होता है. साथ ही, ये Google Maps Platform के प्रीमियम प्लान की पुष्टि करने की सुविधा के साथ काम करती हैं. Java क्लाइंट, Python क्लाइंट, Go क्लाइंट, और Node.js क्लाइंट Google Maps की सेवाओं के लिए, कम्यूनिटी की मदद से काम करने वाली क्लाइंट लाइब्रेरी हैं. इन्हें GitHub पर डाउनलोड किया जा सकता है. साथ ही, GitHub पर योगदान भी दिया जा सकता है. यहां आपको इंस्टॉल करने के निर्देश और सैंपल कोड भी मिलेगा.

अगर आपको जवाब के तौर पर OVER_QUERY_LIMIT स्टेटस कोड मिलता है, तो इसका मतलब है कि आपने एपीआई के लिए, इस्तेमाल करने की सीमाएं पार कर ली हैं. हमारा सुझाव है कि आप इस्तेमाल को ऑप्टिमाइज़ करने की ये रणनीतियां आज़माएं.