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

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

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

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:

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

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

  • मैसेज: 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 के मेटाडेटा के अनुरोध में, अक्षांश/देशांतर की वैल्यू के साथ-साथ पैनोरामा आईडी भेजा है.

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: अनुमति नहीं है

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

  • एपीआई पासकोड मौजूद नहीं है, एसएसएल कनेक्शन मौजूद नहीं है या आपके एपीआई पासकोड को 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 सहायता से संपर्क करें.