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

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

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

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

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

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

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

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

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 से मेल खाता हो. उदाहरण के लिए, roadmap टाइल का अनुरोध करने के लिए, streetview सेशन टोकन का इस्तेमाल नहीं किया जा सकता.

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 की सहायता टीम से संपर्क करें.