गड़बड़ियों को मैनेज करना

अनुरोध करने के बाद, आपको ऐसा जवाब मिल सकता है जिसमें गड़बड़ी की जानकारी शामिल हो.

2D टाइल और Street View की इमेज

यहां दी गई सूची में, 2D टाइल और Street View की इमेज का इस्तेमाल करते समय होने वाली गड़बड़ियों के बारे में बताया गया है.

गड़बड़ियों की सूची

यहां दी गई सूची में, Map Tiles API का इस्तेमाल करते समय होने वाली गड़बड़ियों के बारे में बताया गया है.

required

आपके अनुरोध में यूआरएल पैरामीटर मौजूद नहीं है. ध्यान दें कि गड़बड़ी के मैसेज से पता चलता है कि कौन सा पैरामीटर मौजूद नहीं है.

notFound, invalid

आपकी x, y या z वैल्यू, तय सीमा से बाहर हैं.

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

• सामान्य मैप टाइल के लिए, x कोऑर्डिनेट [0, (2^zoom)-1] के बीच होना चाहिए.

• सामान्य मैप टाइल के लिए, y कोऑर्डिनेट [0, (2^(zoom-1))-1] के बीच होना चाहिए.

• Street View टाइल के लिए, ज़ूम लेवल शून्य से पांच के बीच होना चाहिए. इसमें ये दोनों लेवल भी शामिल हैं.

• Street View टाइल के लिए, x और y कोऑर्डिनेट की रेंज, सामान्य मैप टाइल के लिए इस्तेमाल की जाने वाली रेंज के बराबर होती है. यह रेंज, पांचवें लेवल तक के ज़ूम के लिए लागू होती है. इसके बाद, ज़्यादा से ज़्यादा वैल्यू, imageHeight या imagewidth को tileHeight या tileWidth से भाग देने पर मिलने वाली वैल्यू होती है.

forbidden:

संभावित कारण:

• अनुरोध में मान्य एपीआई पासकोड मौजूद नहीं है.

• मैसेज: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

  ऐसे प्रोजेक्ट में 2D सैटेलाइट टाइल उपलब्ध नहीं हैं जो यूरोपियन इकनॉमिक एरिया (ईईए) के पते वाले बिलिंग खाते से लिंक हैं. ज़्यादा जानकारी के लिए, ईईए में रहने वाले ग्राहकों के लिए Map Tiles API में किए गए बदलाव देखें.

expired

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

badRequest

आपका अनुरोध गलत फ़ॉर्मैट में है. ऐसा इन वजहों से हो सकता है:

• आपने terrain मैप टाइप चुना है, लेकिन इसमें roadmap लेयर शामिल नहीं की है.

• आपने नॉन-रोडमैप मैप टाइप के लिए, styles कलेक्शन शामिल किया है.

• आपने Street View के मेटाडेटा के अनुरोध में, पैनoram आईडी के साथ-साथ अक्षांश/देशांतर की वैल्यू भेजी है.

quotaExceeded, rateLimitExceeded

आपके ऐप्लिकेशन ने तय कोटा पार कर लिया है या हर सेकंड में तय की गई क्वेरी की संख्या से ज़्यादा क्वेरी भेजी हैं.

गड़बड़ी का उदाहरण

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "errors": [
      {
        "message": "The request is missing a valid API key.",
        "domain": "global",
        "reason": "forbidden"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

अनुरोध फिर से करना

जब अनुरोध quotaExceeded और rateLimitExceeded गड़बड़ियों की वजह से पूरे नहीं होते हैं, तो आपको अनुरोध फिर से करना चाहिए. हालांकि, इस बात का ध्यान रखें कि टूटे हुए अनुरोधों या बड़े पैमाने पर होने वाली गड़बड़ियों की वजह से, Google के सर्वर पर ज़्यादा लोड न पड़े. ऐसा इसलिए, क्योंकि कई क्लाइंट, अनुरोधों को तुरंत फिर से करने की कोशिश करते हैं. इसका मतलब है कि अनुरोधों को फिर से करते समय, एक्सपोनेन्शियल बैकऑफ़ का इस्तेमाल करना. एक्सपोनेन्शियल बैकऑफ़ की मदद से, अनुरोधों को कुछ समय के अंतराल पर भेजा जा सकता है, ताकि सर्वर को ठीक होने का समय मिल सके.

उदाहरण के लिए, अगर कोई अनुरोध पूरा नहीं होता है, तो उसे एक सेकंड बाद फिर से करें. हालांकि, अगर वह अनुरोध तब भी पूरा नहीं होता है, तो उसे दो सेकंड बाद फिर से करें. अगर वह अनुरोध तब भी पूरा नहीं होता है, तो उसे चार सेकंड बाद फिर से करें. इस तरह, हर अनुरोध के बीच का समय दोगुना करके, हर अनुरोध को कुछ समय के अंतराल पर भेजा जा सकता है.

3D टाइल

Google के सर्वर से होने वाली गड़बड़ियां आपको शायद न दिखें. ऐसा इसलिए, क्योंकि फ़ोटो जैसा दिखने वाली टाइल को रेंडरर के ज़रिए ऐक्सेस किया जाता है. रेंडरर, सर्वर की गड़बड़ियों को हैंडल करता है.

टाइलों को रेंडर करने में होने वाली गड़बड़ियां

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

सर्वर की गड़बड़ियों को डीबग करने के लिए इस्तेमाल की जाने वाली तकनीक, आपके इस्तेमाल किए जा रहे रेंडरर पर निर्भर करेगी. CesiumJS जैसे ब्राउज़र पर आधारित रेंडरर के लिए, ज़्यादातर ब्राउज़र में मौजूद टूल की मदद से, नेटवर्क ट्रैफ़िक की जांच की जा सकती है. उदाहरण के लिए, आप Chrome DevTools का इस्तेमाल कर सकते हैं.

आम तौर पर होने वाली गड़बड़ियां

यहां दी गई सूची में, आम तौर पर होने वाली गड़बड़ियों के बारे में बताया गया है.

400: अमान्य तर्क दिया गया है

एपीआई पासकोड, क्वेरी पैरामीटर, टाइल/टाइलों के सेट के आईडी अमान्य हैं या सेशन टोकन की समयसीमा खत्म हो गई है.

400: गलत मान

पक्का करें कि createSessionToken अनुरोध के लिए इस्तेमाल किया गया mapType, बाद में टाइल एंडपॉइंट में इस्तेमाल किए गए mapType से मेल खाता हो. उदाहरण के लिए, streetview सेशन टोकन का इस्तेमाल करके, roadmap टाइल का अनुरोध नहीं किया जा सकता.

403: अनुमति नहीं है

संभावित कारण:

• एपीआई पासकोड मौजूद नहीं है, SSL कनेक्शन मौजूद नहीं है या 3D टाइल के लिए, आपका एपीआई पासकोड अनुमति वाली सूची में शामिल नहीं किया गया है. Map Tiles API की 3D टाइल की सुविधा के लिए, अनुमति वाली सूची में शामिल होने के लिए, अपने प्रोजेक्ट आईडी के साथ Google सहायता टीम से संपर्क करें.

• मैसेज: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

  ऐसे प्रोजेक्ट में फ़ोटो जैसा दिखने वाली 3D टाइल उपलब्ध नहीं हैं जो यूरोपियन इकनॉमिक एरिया (ईईए) के पते वाले बिलिंग खाते से लिंक हैं. ज़्यादा जानकारी के लिए, ईईए में रहने वाले ग्राहकों के लिए Map Tiles API में किए गए बदलाव देखें.

429: बहुत सारे अनुरोध मिले हैं

आपका कोटा खत्म हो गया है. अपना कोटा बढ़ाने के लिए, Google सहायता टीम से संपर्क करें.