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

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

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 टाइल के लिए, X और Y निर्देशांक की सीमाएं, सामान्य मैप टाइल के लिए तय की गई सीमाओं जैसी ही होती हैं. हालांकि, यह सीमा पांचवें लेवल तक ही लागू होती है. इस स्थिति में, imageHeight या imagewidth की सबसे बड़ी वैल्यू को tileHeight या tileWidth से भाग दिया जाता है.

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

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

आपका अनुरोध सही नहीं है. ऐसा इन वजहों से हो सकता है:

  • आपने roadmap लेयर शामिल किए बिना, terrain मैप टाइप तय किया है.

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

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

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: अमान्य आर्ग्युमेंट
अमान्य एपीआई कुंजियां, क्वेरी पैरामीटर, टाइल/टाइलसेट आईडी या समयसीमा खत्म हो चुके सेशन टोकन.
403: अनुमति नहीं दी गई
एपीआई कुंजी मौजूद नहीं है, एसएसएल कनेक्शन मौजूद नहीं है या आपकी एपीआई कुंजी को 3D टाइल की अनुमति वाली सूची में नहीं जोड़ा गया है. Map Tiles API की 3D टाइल की सुविधा के लिए अनुमति वाली सूची में शामिल होने के लिए, अपने प्रोजेक्ट आईडी के साथ Google सहायता से संपर्क करें.
429: बहुत ज़्यादा अनुरोध
आपका कोटा खत्म हो गया है. कोटा बढ़ाने के लिए, Google सहायता टीम से संपर्क करें.