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

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

समस्या का हल

समस्या का हल

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

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

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

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

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

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

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

मैं Directions API और Distance Matrix API के लोड होने में लगने वाले समय को कैसे कम करूं?

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

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

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

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

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

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

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

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

  • किसी खास देश के लिए पिन कोड की पाबंदी लगाने के लिए, ISO 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 के लिए जियोकोडिंग करने पर, "मैड्रिड, न्यू मैक्सिको 87010, अमेरिका" दिखता है. हालांकि, अमेरिका के किसी भी दूसरे शहर का नाम "मैड्रिड" नहीं है. 
      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