Maps Static API में गड़बड़ी के मैसेज

अनुरोध पूरा न होने पर, Maps Static API गड़बड़ी या चेतावनी दिखाता है. इस गाइड में, गड़बड़ी के मैसेज के बारे में बताया गया है. साथ ही, उन्हें ठीक करने के निर्देश दिए गए हैं.

अमान्य अनुरोध

अमान्य अनुरोध के लिए, Maps Static API, एचटीटीपी 4xx स्टेटस कोड और समस्या के बारे में बताने वाला मैसेज दिखाता है. इसकी जानकारी यहां दी गई है. किसी समस्या के बारे में ज़्यादा जानने के लिए, एपीआई से मिले गड़बड़ी के कोड और मैसेज देखें.

अनुरोध में अमान्य पैरामीटर शामिल है या ज़रूरी पैरामीटर मौजूद नहीं है. उदाहरण के लिए, size पैरामीटर, संख्या वाली वैल्यू की तय सीमा में नहीं है या अनुरोध में मौजूद नहीं है.
400 BAD REQUEST
अनुरोध में शामिल एपीआई पासकोड अमान्य है.
403 FORBIDDEN

ऐसी गड़बड़ियां जिनकी वजह से मैप नहीं दिखता

अगर अनुरोध मान्य है, लेकिन कोई दूसरी गड़बड़ी होने की वजह से मैप नहीं दिख रहा है, तो Maps Static API, मैप की जगह टेक्स्ट या गड़बड़ी वाली इमेज दिखाता है. उदाहरण के लिए, जब कोई ऐप्लिकेशन इस्तेमाल की सीमाओं को पार कर जाता है, तब गड़बड़ी होती है.

मैप की जगह गड़बड़ी की इमेज दिख रही है
मैप की जगह गड़बड़ी की इमेज दिख रही है

अगर आपने एपीआई कुंजी के बिना Maps Static API का इस्तेमाल किया है या आपके खाते में बिलिंग चालू नहीं है, तो पेज पर मैप की जगह गड़बड़ी वाली इमेज दिखेगी. साथ ही, गड़बड़ी के टाइप के बारे में बताने वाला लिंक भी दिखेगा. उदाहरण के लिए, "g.co/staticmaperror/key."

बिना पासकोड के लॉगिन करने से जुड़ी गड़बड़ियां और उन्हें ठीक करने के तरीके
इस्तेमाल की सीमाओं से जुड़ी गड़बड़ी: मैप लोड करने की रोज़ की तय सीमा पार हो गई है आपने Maps Static API का इस्तेमाल, एपीआई पासकोड के बिना किया हो. इस गड़बड़ी को ठीक करने के लिए, यह तरीका अपनाएं:
  1. एपीआई पासकोड पाना
  2. बिलिंग की सुविधा चालू करें
  3. अपने यूआरएल पर हस्ताक्षर करना
इस्तेमाल की सीमाओं से जुड़ी गड़बड़ी: अनुरोध किए गए यूआरएल में डिजिटल हस्ताक्षर मौजूद नहीं है आपके अनुरोध में ज़रूरी डिजिटल हस्ताक्षर मौजूद नहीं है. इस गड़बड़ी को ठीक करने के लिए, अपने यूआरएल पर हस्ताक्षर करें.

चेतावनियां

गड़बड़ी की कुछ स्थितियों में, एपीआई एक मैप दिखाता है. हालांकि, ऐसा हो सकता है कि मैप में कुछ जानकारी मौजूद न हो. ऐसा होने पर, इन शर्तों का इस्तेमाल करके चेतावनी की पहचान की जा सकती है:

  • मैप पर पीले रंग की गड़बड़ी वाली पट्टी दिख रही है. इस पर "मैप में गड़बड़ी: g.co/staticmaperror." लिखा है.
  • यह एपीआई, X-Staticmap-API-Warning नाम के एचटीटीपी हेडर के तौर पर चेतावनी दिखाता है.

उदाहरण के लिए, यहां दिए गए यूआरएल में markers पैरामीटर की वैल्यू उम्मीद के मुताबिक नहीं है:

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY

एपीआई, मैप दिखाता है. हालांकि, इमेज पर पीले रंग की गड़बड़ी वाला बार दिखता है. इस पर "Map error: g.co/staticmaperror" लिखा होता है:

मैप पर यह गड़बड़ी दिखती है: g.co/staticmaperror
पीले रंग की चेतावनी वाला बार दिखाने वाला मैप

एपीआई, यह एचटीटीपी हेडर भी दिखाता है:

X-Staticmap-API-Warning:Error geocoding: marker 1

यहां दी गई टेबल में, उन चेतावनियों के बारे में बताया गया है जिन्हें एपीआई, एचटीटीपी हेडर के तौर पर दिखा सकता है:

X-Staticmap-API-Warning हेडर में चेतावनियां
Error geocoding: [center, ][marker #number, ][visible #num, ][path #num, ]* अनुरोध को जियोकोड करते समय कोई गड़बड़ी हुई. इस मैसेज के कई वर्शन मौजूद हैं. ये वर्शन, उस एलिमेंट के हिसाब से अलग-अलग होते हैं जहां जियोकोडिंग नहीं हो पाई. जैसे, center, marker, visible या path. साथ ही, यह मैसेज उन एलिमेंट की संख्या के हिसाब से भी अलग-अलग होता है जहां जियोकोडिंग नहीं हो पाई. इस चेतावनी का एक उदाहरण X-Staticmap-API-Warning:Error geocoding: marker 1 है, जैसा कि ऊपर दिए गए उदाहरण में दिखाया गया है.
Too many geocoded markers requested (max is 15). अनुरोध में, ऐसे पते वाले मार्कर की संख्या तय सीमा से ज़्यादा है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. ज़्यादा से ज़्यादा 15 फ़िल्टर जोड़े जा सकते हैं. यह सीमा सिर्फ़ उन मार्कर पर लागू होती है जिन्हें ऐसे पते के तौर पर सेट किया गया है जिसे लोग आसानी से पढ़ सकते हैं. साथ ही, जिन्हें जियोकोड करने की ज़रूरत होती है. यह अक्षांश और देशांतर के निर्देशांकों के साथ तय किए गए मार्कर पर लागू नहीं होता.
Too many geocoded polyline vertices requested (max is 15). अनुरोध में, पढ़े जा सकने वाले पते के साथ, तय सीमा से ज़्यादा पॉलीलाइन दी गई हैं. ज़्यादा से ज़्यादा 15 फ़िल्टर जोड़े जा सकते हैं. यह सीमा सिर्फ़ उन पॉलीलाइन पर लागू होती है जिनके वर्टेक्स को ऐसे पतों के तौर पर बताया गया है जिन्हें लोग आसानी से समझ सकते हैं. साथ ही, जिनके लिए जियोकोडिंग की ज़रूरत होती है. यह अक्षांश और देशांतर के निर्देशांकों के साथ तय की गई पॉलीलाइन पर लागू नहीं होता.

आपको एचटीटीपी हेडर से जुड़ी चेतावनियां, Chrome DevTools कंसोल, Firefox वेब कंसोल या आपके ब्राउज़र में मौजूद अन्य मिलते-जुलते टूल में दिख सकती हैं.