Maps स्टैटिक एपीआई में गड़बड़ी के मैसेज

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

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

कोई अमान्य अनुरोध होने पर, Maps स्टैटिक एपीआई एक एचटीटीपी 4xx स्टेटस कोड और समस्या के बारे में जानकारी देने वाला मैसेज दिखाता है. गड़बड़ी से जुड़ी ऐसी स्थितियों के उदाहरण नीचे दिए गए हैं. ध्यान दें: यह संभावित गड़बड़ियों की पूरी सूची नहीं है. खास समस्याओं के बारे में जानने के लिए, एपीआई से मिला गड़बड़ी का असल कोड और भेजा गया मैसेज देखें.

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

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

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

मैप के बजाय गड़बड़ी वाली इमेज दिखाई गई है
इमेज: मैप के बजाय गड़बड़ी वाली इमेज दिखती है

अगर एपीआई पासकोड के बिना Maps स्टैटिक एपीआई का इस्तेमाल किया जाता है या आपके खाते पर बिलिंग की सुविधा चालू नहीं है, तो पेज पर मैप के बजाय गड़बड़ी वाली इमेज दिखेगी. साथ ही, एक लिंक होगा जिसमें गड़बड़ी के टाइप के बारे में बताया जाएगा. उदाहरण के लिए, "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

एपीआई आपको मैप दिखाता है, लेकिन इमेज के ऊपर पीले रंग का गड़बड़ी वाला बार दिखाया जाता है. इस बार में "मैप में गड़बड़ी: 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, ]* अनुरोध को जियोकोड करते समय कोई गड़बड़ी हुई. इस मैसेज के कई वैरिएंट हैं. हालांकि, यह इस बात पर निर्भर करता है कि किस एलिमेंट में जियोकोडिंग नहीं हो सकी (केंद्र, मार्कर, दिख रहा है या पाथ) और कितने एलिमेंट पूरे नहीं हो सके. इस चेतावनी का एक उदाहरण 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 Web Console या अपने ब्राउज़र के ऐसे ही दूसरे टूल में एचटीटीपी हेडर से जुड़ी चेतावनियां देखी जा सकती हैं.