जियोकोडिंग के बारे में अक्सर पूछे जाने वाले सवाल

इस अक्सर पूछे जाने वाले सवालों में, Geocoding API से जुड़े सवालों के जवाब दिए गए हैं. Google Maps Platform से जुड़े सामान्य सवालों के जवाब पाने के लिए, Google Maps Platform के बारे में अक्सर पूछे जाने वाले सवाल देखें. पतों को जियोकोड करने के सबसे सही तरीके भी देखें.

समस्या का हल

समस्या का हल

मुझे ऐसी ज़्यादा क्वेरी मिल रही हैं जिनके लिए जियोकोडर, ZERO_RESULTS दिखाता है. आपको कम्यूनिटी दिशा-निर्देशों और नीतियों का उल्लंघन करने वाला किस तरह का कॉन्टेंट मिला?

जियोकोडर में, अस्पष्ट, अधूरी, और खराब फ़ॉर्मैट वाली क्वेरी से ZERO_RESULTS मिल सकता है. जैसे, गलत स्पेलिंग वाले या मौजूद न होने वाले पते. अगर पता नहीं मिलता है, तो अधूरे नतीजे (उदाहरण के लिए, पते के बजाय सिर्फ़ उपनगरीय इलाका दिखाना) के बजाय, ZERO_RESULTS दिखाना बेहतर होता है.

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

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

मुझे तुरंत जवाब चाहिए. हालांकि, जियोकोडर मेरे ऐप्लिकेशन के लिए बहुत धीमा है. तेज़ी से जवाब पाने के लिए, मैं क्या इस्तेमाल करूँ?

हमारा सुझाव है कि उपयोगकर्ता के इनपुट के आधार पर काम करने वाले ऐप्लिकेशन, पते की जियोकोडिंग के बजाय Places API में जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा का इस्तेमाल करें. यह सुविधा JavaScript, Android या iOS में भी उपलब्ध है. किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा को इंटरैक्टिव तरीके से इस्तेमाल करने के लिए ऑप्टिमाइज़ किया गया है. इसलिए, इसमें बहुत कम समय लगता है.

Geocoding API में पता जियोकोडिंग की सुविधा, पूरी जानकारी वाले, साफ़ तौर पर बताए गए, और सही फ़ॉर्मैट वाले पतों के साथ इस्तेमाल करने के लिए ऑप्टिमाइज़ की गई है. जैसे, ऑनलाइन फ़ॉर्म में डाले गए डिलीवरी के पते. इसलिए, इसमें Place Autocomplete की तुलना में ज़्यादा समय लगता है. फ़ॉरवर्ड जियोकोडर ज़्यादा कवरेज देता है और इसके नतीजे बेहतर होते हैं. हालांकि, इसमें कुछ हद तक ज़्यादा समय लगता है.

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

वेपॉइंट, शुरुआत की जगह, और मंज़िल की जानकारी देने के लिए, पतों के बजाय जगह के आईडी का इस्तेमाल करें. जगह के आईडी, Places API में किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा या Maps JavaScript API में जगहों की लाइब्रेरी से सबसे बेहतर तरीके से मिलते हैं. placeIdOnly विकल्प के बारे में भी जानकारी देखें. इसका इस्तेमाल, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा की लागत को कम करने के लिए किया जा सकता है.

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

मैं जियोकोडर में मौजूद गड़बड़ियों की शिकायत कैसे करूं?

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

जियोकोडर, इस्तेमाल के मेरे उदाहरण के लिए अच्छे नतीजे नहीं दे रहा है. कौनसी मदद उपलब्ध है?

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

मैं कॉम्पोनेंट फ़िल्टर करने की सुविधा का इस्तेमाल करके, जियोकोडर से सबसे अच्छे नतीजे कैसे पाऊं?

जियोकोडर में, कॉम्पोनेंट फ़िल्टर करने की सुविधा सिर्फ़ postal_code और country पाबंदियां लागू करती है. यहां दिए गए उदाहरणों में, कॉम्पोनेंट फ़िल्टर करने की सुविधा का सबसे सही तरीके से इस्तेमाल करने का तरीका बताया गया है. यह इस बात पर निर्भर करता है कि आपको किस तरह के नतीजे चाहिए. सैंपल अनुरोध के यूआरएल में, `YOUR_API_KEY` को अपने असल एपीआई पासकोड से बदलना न भूलें.

  • अगर आपको किसी देश के लिए पिन कोड सीमित करने हैं, तो पक्का करें कि आपने आईएसओ 3166-2 देश के कोड का इस्तेमाल करके, देश से जुड़ी पाबंदियां तय की हों. उदाहरण के लिए: components=country:CH|postal_code:8000 से, नतीजे के तौर पर "8000 Zürich, Switzerland" मिलता है. 
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • क्वेरी को किसी खास देश तक सीमित करने के लिए, ISO 3166-2 देश के कोड का इस्तेमाल करके, देश से जुड़ी पाबंदी ज़रूर तय करें. देश के नामों और अन्य छोटे नामों से, देश के कोड के मुकाबले अलग नतीजे मिल सकते हैं.

    उदाहरण:

    • components=country:FRA|locality:gallus के लिए जियोकोडिंग करने पर, जर्मनी के फ़्रैंकफ़र्ट एम मेन में मौजूद गैलस की सबलोकैलिटी मिलती है. ऐसा इसलिए है, क्योंकि फ़्रांस के लिए तीन अक्षरों वाला देश का कोड (FRA) इस्तेमाल नहीं किया जा सकता. इसलिए, किसी भी देश में नतीजे दिखाने की अनुमति है. साथ ही, फ़्रैंकफ़र्ट में दिखाया गया नतीजा, फ़्रांस में दिखाए गए किसी भी नतीजे से ज़्यादा काम का है. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • ऐसा ज़रूरी नहीं है कि Geocoding API, अस्पष्ट क्वेरी के लिए एक से ज़्यादा नतीजे दिखाए. इस तरह की क्वेरी के लिए, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा बेहतर जवाब देती है.

    उदाहरण:

    • जियोकोडिंग के लिए components=country:US|locality:madrid "Madrid, NM 87010, USA" दिखाता है, लेकिन अमेरिका में "Madrid" नाम के किसी अन्य शहर की जानकारी नहीं दिखाता है. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • input=madrid&components=country:us&types=(regions) के लिए, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा का इस्तेमाल करने और location और radius का इस्तेमाल करके व्यूपोर्ट की जानकारी देने से, जगह के नतीजों को बायस किया जा सकता है. इससे अमेरिका के कई शहरों के नाम "मैड्रिड" के तौर पर जनरेट होते हैं. 
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY