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

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

समस्या हल करना

समस्या हल करना

मुझे ऐसी और क्वेरी मिल रही हैं जो जियोकोडर के साथ ZERO_RESULTS देती हैं. ऐसा क्यों हो रहा है?

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

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

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

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

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

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

मैं निर्देशों एपीआई और दूरी मैट्रिक्स एपीआई पर इंतज़ार के समय को कैसे कम करूं?

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

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

मैं जियोकोडर में बग की रिपोर्ट कैसे करूं?

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

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

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

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

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

  • किसी खास देश के पिन कोड पर पाबंदी लगाने के लिए, ISO 3166-2 देश कोड का इस्तेमाल करके, देश से जुड़ी पाबंदी की जानकारी दें. उदाहरण के लिए: components=country:CH|postal_code:8000 "8000 मुंबई, स्विट्ज़रलैंड" दिखाता है. 
    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
  • यह ज़रूरी नहीं है कि जियोकोडिंग एपीआई संदिग्ध क्वेरी के लिए एक से ज़्यादा नतीजे दिखाए. 'जगह की जानकारी ऑटोकंप्लीट' सुविधा, इस तरह की क्वेरी का बेहतर जवाब देती है.

    उदाहरण:

    • components=country:US|locality:madrid के लिए जियोकोडिंग से "Madrid, NM 87010, USA" दिखता है, लेकिन अमेरिका के किसी भी शहर का नाम "मैड्रिड" नहीं है. 
      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