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

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

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 टाइल के लिए, ज़ूम लेवल 0 से 5 के बीच होना चाहिए.

• 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 सैटलाइट टाइल, उन प्रोजेक्ट में उपलब्ध नहीं हैं जो यूरोपियन इकनॉमिक एरिया (ईईए) के पते वाले बिलिंग खाते से जुड़े हैं. इसके विकल्पों में Maps JavaScript API, Android के लिए Maps SDK या iOS के लिए Maps SDK शामिल हैं. ज़्यादा जानकारी के लिए, ईईए के ग्राहकों के लिए Map Tiles API में किए गए बदलाव लेख पढ़ें.

expired

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

badRequest

आपका अनुरोध गलत तरीके से किया गया था. इसकी सामान्य वजहें ये हैं:

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

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

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

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: अमान्य वैल्यू

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

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

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

• एपीआई पासकोड या एसएसएल कनेक्शन मौजूद नहीं है. इसके अलावा, ऐसा हो सकता है कि आपका एपीआई पासकोड, 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 टाइल, उन प्रोजेक्ट में उपलब्ध नहीं हैं जो यूरोपियन इकनॉमिक एरिया (ईईए) के पते वाले बिलिंग खाते से लिंक हैं. इसके विकल्पों में, Maps JavaScript API, Android के लिए Maps SDK या iOS के लिए Maps SDK में मौजूद 3D Maps की सुविधा शामिल है. ज़्यादा जानकारी के लिए, ईईए के ग्राहकों के लिए Map Tiles API में किए गए बदलाव लेख पढ़ें.

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

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