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

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

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

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].

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

  • स्ट्रीट व्यू टाइल के लिए, 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 लेयर शामिल किए बिना, terrain मैप टाइप चुना है.roadmap

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

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