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

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

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

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

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

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

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

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

अगर एपीआई पासकोड के बिना 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

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