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