शुरू करें

सुविधा के बारे में जानकारी

Maps स्टैटिक एपीआई, यूआरएल के ज़रिए एचटीटीपी अनुरोध के जवाब में इमेज (GIF, PNG या JPEG) दिखाता है. हर अनुरोध के लिए, आप मैप की जगह, इमेज का साइज़, ज़ूम का लेवल, मैप का टाइप, और मैप पर दूसरी जगहों पर वैकल्पिक मार्कर के प्लेसमेंट की जानकारी दे सकते हैं. इसके अलावा, अक्षर और अंक का इस्तेमाल करके मार्कर को लेबल किया जा सकता है.

Maps स्टैटिक एपीआई इमेज को <img> टैग के src एट्रिब्यूट या दूसरी प्रोग्रामिंग भाषाओं में इसकी तरह ही जोड़ा जाता है.

इस दस्तावेज़ में Maps स्टैटिक स्टैटिक यूआरएल और उपलब्ध पैरामीटर के ज़रूरी फ़ॉर्मैट के बारे में बताया गया है. यह आपके यूआरएल की जानकारी देने के लिए कुछ सलाह और सुझाव भी दिखाता है.

शुरू करने से पहले

यह दस्तावेज़ उन वेबसाइट और मोबाइल डेवलपर के लिए है जिन्हें वेबपेज या मोबाइल ऐप्लिकेशन में, Maps स्टैटिक एपीआई इमेज को शामिल करना है. इसमें, उपलब्ध पैरामीटर के बारे में बताया गया है, जिसमें एपीआई और रेफ़रंस कॉन्टेंट का इस्तेमाल किया जाता है.

Maps स्टैटिक एपीआई के साथ डेवलप करने से पहले, पुष्टि करने की ज़रूरी शर्तें (आपको एपीआई कुंजी की ज़रूरत होती है) और एपीआई के इस्तेमाल और बिलिंग की जानकारी (आपको अपने प्रोजेक्ट की बिलिंग चालू करनी होगी) देखें.

यूआरएल पैरामीटर

मैप स्टैटिक एपीआई यूआरएल, इस फ़ॉर्मैट में होना चाहिए:

https://maps.googleapis.com/maps/api/staticmap?parameters

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

https://maps.googleapis.com/maps/api/staticmap?parameters

एचटीटीपी या एचटीटीपीएस का इस्तेमाल करते समय, कुछ यूआरएल पैरामीटर ज़रूरी होते हैं, जबकि कुछ वैकल्पिक होते हैं. जैसा कि यूआरएल के मानक के तौर पर होता है, सभी पैरामीटर को ampersand (&) वर्ण का इस्तेमाल करके अलग किया जाता है. पैरामीटर की सूची और उनकी संभावित वैल्यू को इस दस्तावेज़ में शामिल किया गया है.

अहम जानकारी: यूआरएल पैरामीटर की चर्चा में ऐसे उदाहरण शामिल हैं जो पहले से एस्केप करने के तरीके में साफ़ तौर पर दिए गए हैं. एपीआई को कोई भी अनुरोध भेजने से पहले, उसके पैरामीटर को यूआरएल कोड में बदला गया होना चाहिए. उदाहरण के लिए, कई पैरामीटर एक विभाजक (|) का इस्तेमाल विभाजक के रूप में करते हैं, जिसे फ़ाइनल यूआरएल में %7C के रूप में एन्कोड किया जाना चाहिए, जैसा कि इस दस्तावेज़ में सबसे ऊपर दिए गए झटपट उदाहरण में दिखाया गया है. ज़्यादा जानकारी के लिए, मान्य यूआरएल बनाना देखें.

Maps स्टैटिक एपीआई, मैप यूआरएल की इमेज के लिए इन यूआरएल पैरामीटर का इस्तेमाल करता है:

लोकेशन पैरामीटर

• center (अगर मार्कर मौजूद न हों, तो ज़रूरी है) मैप के बीच के हिस्से को परिभाषित करता है, जो मैप के सभी किनारों से बराबर होता है. यह पैरामीटर जगह को कॉमा से अलग किए गए {Latitude,देशांतर} पेयर (उदाहरण के लिए, "40.714728,-73.998672") या स्ट्रिंग के पते के तौर पर लेता है (जैसे, "सिटी हॉल, न्यूयॉर्क, NY") पृथ्वी के चेहरे पर किसी खास जगह की पहचान करता है. ज़्यादा जानकारी के लिए, जगहें देखें.
• zoom (मार्कर मौजूद न होने पर ज़रूरी है) मैप के ज़ूम का लेवल बताता है, जो मैप का ज़ूम करने का लेवल तय करता है. यह पैरामीटर, चुने गए इलाके के ज़ूम के हिसाब से संख्या वाला मान लेता है. ज़्यादा जानकारी के लिए, ज़ूम करने के लेवल देखें.

मैप पैरामीटर

• size (ज़रूरी है) मैप की इमेज के आयताकार डाइमेंशन की जानकारी देता है. यह पैरामीटर फ़ॉर्म की स्ट्रिंग लेता है {horizontal_value}x{vertical_value}. उदाहरण के लिए, 500x400 मैप को 500 पिक्सल चौड़ा और 400 पिक्सल ऊंचा बताता है. 180 पिक्सल से छोटे चौड़ाई वाले मैप पर, Google का कम साइज़ का लोगो दिखेगा. इस पैरामीटर पर, scale पैरामीटर का असर पड़ता है. आखिरी आउटपुट साइज़, साइज़ और स्केल वैल्यू का प्रॉडक्ट होता है.
• scale (ज़रूरी नहीं) लौटाए गए पिक्सल की संख्या पर असर डालता है. scale=2 एक ही कवरेज एरिया और जानकारी के लेवल को बनाए रखते हुए, scale=1 के मुकाबले दोगुनी पिक्सल वैल्यू दिखाता है (यानी कि मैप के कॉन्टेंट में कोई बदलाव नहीं होता). हाई-रिज़ॉल्यूशन डिसप्ले के लिए डेवलप करते समय यह तरीका मददगार होता है. डिफ़ॉल्ट वैल्यू 1 है. स्वीकार की जाने वाली वैल्यू 1 और 2 हैं. ज़्यादा जानकारी के लिए, स्केल वैल्यू देखें.
• format (ज़रूरी नहीं) नतीजे वाली इमेज का फ़ॉर्मैट बताता है. डिफ़ॉल्ट रूप से, Maps स्टैटिक एपीआई PNG इमेज बनाता है. GIF, JPEG, और PNG टाइप के कई तरह के फ़ॉर्मैट उपलब्ध हैं. इमेज किस तरीके से दिखाई जानी चाहिए, यह इस बात पर निर्भर करता है कि उसे किस फ़ॉर्मैट में इस्तेमाल किया जाएगा. JPEG आम तौर पर ज़्यादा कंप्रेस करता है, जबकि GIF और PNG ज़्यादा जानकारी देते हैं. ज़्यादा जानकारी के लिए, इमेज फ़ॉर्मैट देखें.
• maptype (वैकल्पिक) बनाने के लिए मैप का प्रकार बताता है. मैपटाइप की कई वैल्यू मौजूद हो सकती हैं. इनमें roadmap, satellite, hybrid, और terrain शामिल हैं. ज़्यादा जानकारी के लिए, Maps स्टैटिक एपीआई मैपटाइप देखें.
• language (ज़रूरी नहीं) मैप टाइल पर लेबल दिखाने के लिए इस्तेमाल की जाने वाली भाषा के बारे में बताता है. ध्यान दें कि यह पैरामीटर सिर्फ़ कुछ देशों के टाइल के लिए काम करता है. अगर अनुरोध की गई कोई खास भाषा, टाइल सेट के लिए काम नहीं करती है, तो उस टाइलसेट के लिए डिफ़ॉल्ट भाषा का इस्तेमाल किया जाएगा.
• region (ज़रूरी नहीं) देश या इलाके के हिसाब से संवेदनशील जानकारी के आधार पर, दिखाई जाने वाली सही बॉर्डर के बारे में बताता है. दो वर्णों वाले ccTLD ('टॉप-लेवल डोमेन') की वैल्यू के तौर पर बताए गए क्षेत्र कोड को स्वीकार करता है. जिन इलाकों में यह सुविधा उपलब्ध है उनके लिए Google Maps Platform की कवरेज की जानकारी देखें.

फ़ीचर पैरामीटर

• map_id (ज़रूरी नहीं) किसी खास मैप के लिए आइडेंटिफ़ायर बताता है. मैप आईडी, मैप को किसी खास स्टाइल या सुविधा से जोड़ता है. साथ ही, यह ज़रूरी है कि वह उसी प्रोजेक्ट से जुड़ा हो जिसका इस्तेमाल एपीआई इनीशियलाइज़ करने के लिए किया गया था. ज़्यादा जानकारी के लिए, मैप आईडी का इस्तेमाल करना देखें.
• markers (ज़रूरी नहीं) एक खास जगह पर इमेज से अटैच करने के लिए, एक या उससे ज़्यादा मार्कर तय करें. पाइप पैरामीटर से अलग किए गए पैरामीटर के साथ यह पैरामीटर सिंगल मार्कर परिभाषा लेता है (|). एक से ज़्यादा मार्कर एक ही markers पैरामीटर में रखे जा सकते हैं, बशर्ते वे एक ही शैली को दिखाएं; अतिरिक्त markers पैरामीटर जोड़कर आप अलग-अलग शैलियों के दूसरे मार्कर जोड़ सकते हैं. ध्यान दें कि अगर आप किसी मैप के लिए मार्कर देते हैं, तो आपको center और zoom पैरामीटर के बारे में बताने की ज़रूरत नहीं होती है. ज़्यादा जानकारी के लिए, Maps स्टैटिक एपीआई मार्कर देखें.
• path (वैकल्पिक) तय की गई जगहों पर इमेज को ओवरले करने के लिए, दो या ज़्यादा कनेक्ट किए गए पॉइंट का एक पाथ बताता है. यह पैरामीटर, पॉइंट वर्ण की स्ट्रिंग को (|) पाइप वर्ण से अलग करता है या पाथ की जगह के एलान में enc: प्रीफ़िक्स का इस्तेमाल करके, कोड में बदली गई पॉलीलाइन को अलग करता है. अतिरिक्त path पैरामीटर जोड़कर, अन्य पाथ दिए जा सकते हैं. ध्यान दें कि अगर मैप के लिए पाथ दिया जाता है, तो आपको center और zoom पैरामीटर तय करने की ज़रूरत नहीं होती है. ज़्यादा जानकारी के लिए, Maps स्टैटिक एपीआई पाथ देखें.
• visible (वैकल्पिक) एक या ज़्यादा जगहें दिखाता है, जो मैप पर दिखाई देती रहनी चाहिए. हालांकि, कोई मार्कर या दूसरे संकेत नहीं दिखाए जाएंगे. इस पैरामीटर का इस्तेमाल करके पक्का करें कि कुछ सुविधाएं या मैप लोकेशन Maps स्टैटिक एपीआई में दिख रही हैं.
• style (वैकल्पिक) मैप की खास सुविधा (सड़क, पार्क, और दूसरी सुविधाएं) के प्रज़ेंटेशन में बदलाव करने के लिए, पसंद के मुताबिक शैली तय करता है. इस पैरामीटर में, सुविधाओं की पहचान करने के लिए, feature और element आर्ग्युमेंट का इस्तेमाल किया जाता है. साथ ही, चुनी गई सुविधाओं पर लागू होने के लिए स्टाइल ऑपरेशन का एक सेट भी मिलता है. अतिरिक्त style पैरामीटर जोड़कर कई स्टाइल दिए जा सकते हैं. ज़्यादा जानकारी के लिए, स्टाइल मैप की गाइड देखें.

कुंजी और हस्ताक्षर के पैरामीटर

• key (ज़रूरी है) की मदद से, Google Cloud Console में जाकर, अपने ऐप्लिकेशन के एपीआई के इस्तेमाल पर नज़र रखी जा सकती है. साथ ही, यह पक्का हो जाता है कि ज़रूरत पड़ने पर Google आपके ऐप्लिकेशन के बारे में आपसे संपर्क कर सके. ज़्यादा जानकारी के लिए, Maps स्टैटिक एपीआई के साथ एपीआई कुंजियों का इस्तेमाल करना देखें.
• signature (सुझाया गया) एक डिजिटल हस्ताक्षर है. इसका इस्तेमाल यह पुष्टि करने के लिए किया जाता है कि आपकी एपीआई कुंजी का इस्तेमाल करके, जो साइट जनरेट कर रहे हैं वे ऐसा कर सकते हैं. इसके लिए, बिना डिजिटल हस्ताक्षर वाले अनुरोध पूरे नहीं किए जा सकेंगे. ज़्यादा जानकारी के लिए, डिजिटल हस्ताक्षर का इस्तेमाल करें देखें.

यूआरएल के साइज़ की पाबंदी

Maps स्टैटिक एपीआई यूआरएल में 8,192 से ज़्यादा वर्ण नहीं होने चाहिए. ऐसा हो सकता है कि आपको इससे ज़्यादा यूआरएल की ज़रूरत न पड़े. हालांकि, ऐसा करने के लिए आपको कई मार्कर और पाथ वाले कॉम्प्लेक्स मैप बनाने होंगे.

पैरामीटर का इस्तेमाल

Maps स्टैटिक एपीआई को इस्तेमाल करना आसान है, क्योंकि इसमें सिर्फ़ पैरामीटर वाला यूआरएल शामिल होता है. इस सेक्शन में बताया गया है कि यूआरएल बनाने के लिए इन पैरामीटर का इस्तेमाल कैसे करें.

जगहों की जानकारी देना

Maps स्टैटिक एपीआई, मैप पर जगहों की सटीक तरीके से पहचान कर पाना चाहिए, दोनों ही मैप को सही जगह पर फ़ोकस कर सकते हैं (center पैरामीटर का इस्तेमाल करके) और/या किसी वैकल्पिक प्लेसमार्क को मैप के जगहों पर रख सकते हैं (markers पैरामीटर का इस्तेमाल करके). Maps स्टैटिक एपीआई, इन जगहों की जानकारी देने के लिए नंबर (अक्षांश और देशांतर वैल्यू) या स्ट्रिंग (पतों) का इस्तेमाल करती है. ये वैल्यू किसी जियोकोड की गई जगह की पहचान करती हैं.

कई पैरामीटर (जैसे कि markers और path पैरामीटर) एक से ज़्यादा जगहों पर लगाए जाते हैं. ऐसे मामलों में, जगहों को पाइप (|) वर्ण से अलग किया जाता है.

अक्षांश और देशांतर

अक्षांश और देशांतर को कॉमा-सेपरेटेड टेक्स्ट स्ट्रिंग में अंकों की मदद से तय किया जाता है. इन स्ट्रिंग में, दशमलव के बाद छह अंक तक होते हैं. उदाहरण के लिए, "40.714728,-73.998672" एक मान्य भौगोलिक मान है. दशमलव के बाद छह जगहों से ज़्यादा सटीक नहीं माना जाता है.

देशांतर की वैल्यू, इंग्लैंड के ग्रीनविच से उनकी दूरी के आधार पर तय की जाती हैं. ग्रीनविच, 51.477222 अक्षांश पर स्थित है, इसलिए हम ग्रीनविच पर मैप को केंद्र में लाने के लिए center का मान 51.477222,0 डाल सकते हैं

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

अक्षांश और देशांतर वैल्यू पृथ्वी के चेहरे पर मान्य जगह से मेल खानी चाहिए. अक्षांश -90 और 90 के बीच कोई भी मान ले सकते हैं, जबकि देशांतर मान -180 और 180 के बीच कोई भी मान ले सकते हैं. अगर आप अमान्य अक्षांश या देशांतर वैल्यू बताते हैं, तो आपका अनुरोध खराब अनुरोध के तौर पर अस्वीकार कर दिया जाएगा.

पते

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

अक्षांश/देशांतर की जानकारी देने वाले किसी भी पैरामीटर में, इसके बजाय, आपके पास पता बताने वाली स्ट्रिंग होती है. Google, पते को वेब पते में जोड़ देगा और Maps स्टैटिक एपीआई की सेवा देगा. इसका इस्तेमाल मार्कर लगाने या जगहों की जानकारी देने के लिए किया जाएगा. स्ट्रिंग, यूआरएल कोड में बदली गई होनी चाहिए. इसलिए, जैसे कि "सिटी हॉल, न्यूयॉर्क,एनवाई" को "शहर+हाल,नया+York,NY" में बदला जाना चाहिए.

ध्यान दें कि पते मोहल्ले के पते, नाम वाले रास्तों जैसी पॉलीलाइन या शहरों, देशों या राष्ट्रीय उद्यानों जैसे पॉलीगॉन के इलाकों जैसी सटीक जगहें दिखा सकते हैं. पॉलीलाइनर और बहुभुज परिणामों के लिए, Maps स्टैटिक एपीआई सर्वर लाइन/क्षेत्र के केंद्र बिंदु को पता केंद्र के रूप में इस्तेमाल करेगा. अगर आपको इस बात की जानकारी नहीं है कि कोई पता भौगोलिक कैसे हो सकता है, तो इस जियोकोडिंग सुविधा का इस्तेमाल करके पते की जांच की जा सकती है.

ध्यान दें: अगर आपको किसी ऐसी जगह की मदद से जगहों की जानकारी देनी है जिसके लिए जियोकोडिंग की ज़रूरत होती है, तो इस पते को ज़्यादा से ज़्यादा 15 जगहों तक ही सीमित किया जा सकता है. जैसे, लोगों के लिए पता की स्ट्रिंग या पॉलीलाइन. यह सीमा सिर्फ़ उन जगहों पर लागू होती है जहां जगह की जानकारी की ज़रूरत होती है. यह अक्षांश/देशांतर निर्देशांकों में बताई गई जगहों पर लागू नहीं होता है.

नीचे दिया गया उदाहरण, बर्कली, CA के लिए एक स्टैटिक मैप इमेज जनरेट करता है:

https://maps.googleapis.com/maps/api/staticmap?center=Berkeley,CA&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

ज़ूम लेवल

Google मैप पर मैप में एक पूर्णांक 'ज़ूम स्तर' होता है, जो वर्तमान दृश्य का रिज़ॉल्यूशन परिभाषित करता है. डिफ़ॉल्ट roadmap व्यू से 0 (सबसे नीचे ज़ूम लेवल, जिसमें पूरी दुनिया एक ही मैप पर देखी जा सकती है) और 21+ (सड़कों और अलग-अलग इमारतों तक) के बीच ज़ूम लेवल संभव है. जहां मौजूद हो, वहां बिल्डिंग की आउटलाइन, ज़ूम लेवल 17 पर मैप पर दिखती है. यह वैल्यू, हर इलाके के हिसाब से अलग-अलग होती है. समय के साथ, जैसे-जैसे डेटा बढ़ता है, वैसे-वैसे यह डेटा बदल भी सकता है.

Google Maps में, ज़ूम लेवल 0 को सेट किया गया है. इसके तहत, पूरी दुनिया के नज़ारे दिखते हैं. सफल होने वाले हर ज़ूम लेवल पर, हॉरिज़ॉन्टल और वर्टिकल, दोनों तरह के डाइमेंशन सटीक होते हैं. इसके काम करने के तरीके के बारे में ज़्यादा जानने के लिए, Google Maps पर JavaScript एपीआई के दस्तावेज़ देखें.

ध्यान दें: सभी ज़ूम स्तर पृथ्वी पर सभी स्थानों पर नहीं दिखते. ज़ूम के लेवल, जगह के हिसाब से अलग-अलग होते हैं. ऐसा इसलिए होता है, क्योंकि ग्लोब के कुछ हिस्सों में मौजूद डेटा, दूसरी जगहों के डेटा से ज़्यादा होता है.

अगर आप उस ज़ूम लेवल के लिए अनुरोध भेजते हैं जिसमें कोई मैप टाइल मौजूद नहीं है, तो Maps स्टैटिक एपीआई खाली इमेज दिखाएगा.

नीचे दी गई सूची में, हर ज़ूम लेवल पर मौजूद जानकारी का अनुमानित लेवल दिखाया जाता है:

• 1: दुनिया
• 5: लैंडमास/महाद्वीप
• 10: शहर
• 15: सड़कें
• 20: इमारतें

इस उदाहरण में मैनहैटन के दो मैप के लिए एक जैसे center वैल्यू का अनुरोध किया गया है. हालांकि, ज़ूम लेवल 12 और 14 पर इसे दिखाने का अनुरोध किया गया है:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

  

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

चित्र का आकार

center के साथ size पैरामीटर, मैप के कवरेज एरिया की जानकारी देता है. यह scale वैल्यू (जो डिफ़ॉल्ट रूप से 1 है) से गुणा करने पर, मैप का आउटपुट साइज़ भी पिक्सल में बताता है.

इस टेबल में, हर scale वैल्यू पर मौजूद size पैरामीटर के लिए ज़्यादा से ज़्यादा वैल्यू डाली जा सकती हैं.

scale=1	scale=2
640x640	640x640 (1280x1280 पिक्सल का इस्तेमाल करता है)

यह उदाहरण भूमध्य रेखा पर ज़ूम लेवल 1 पर पृथ्वी की "स्लाइस" का अनुरोध करता है:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=400x50&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

इस उदाहरण में उसी क्षेत्र पर केंद्रित, 100 x 100 पिक्सल आकार वाले एक छोटे मैप का अनुरोध किया गया है. Google का छोटा लोगो ध्यान दें:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=100x100&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

स्केल वैल्यू

Maps स्टैटिक एपीआई का size पैरामीटर, मैप के साइज़ को पिक्सल में बताता है. इस तरह, size=200x200 वाला मैप, 200 पिक्सल x 200 पिक्सल का होगा. एक एलसीडी कंप्यूटर मॉनिटर पर, जो आम तौर पर करीब 100 पिक्सल प्रति इंच (पीपीआई) दिखाता है, 200x200 मैप हर डाइमेंशन में करीब 2 इंच का होगा.

हालांकि, मोबाइल डिवाइस में 300ppi से ज़्यादा पिक्सल डेंसिटी वाली हाई रिज़ॉल्यूशन वाली स्क्रीन शामिल होती हैं, जो:

• 200x200 पिक्सल इमेज का साइज़ कम करके सिर्फ़ 0.7 इंच करें, इमेज को रेंडर करने के लिए, लेबल और आइकॉन बहुत छोटे हों; या
• आसानी से पढ़ने लायक बनाने के लिए इमेज को स्केल (ज़ूम) करें. इससे इमेज धुंधली या पिक्सलेट हो जाएगी.

बहुत छोटा है	बहुत धुंधला

मोबाइल डिवाइसों के लिए डेवलपमेंट के दौरान, एपीआई के scale पैरामीटर का इस्तेमाल किया जा सकता है. ऐसा करने से, हाई रिज़ॉल्यूशन वाली मैप इमेज मिलती हैं, जिनमें ऊपर बताई गई समस्याएं शामिल होती हैं. मैप के कवरेज एरिया को बदले बिना, scale वैल्यू को size में गुणा किया जाता है, ताकि इमेज के असल आउटपुट साइज़ का पता लगाया जा सके. डिफ़ॉल्ट scale वैल्यू 1 है. वैल्यू 1 और 2 हैं.

उदाहरण के लिए, 2 में मौजूद स्केल की वैल्यू, उसी मैप कवरेज एरिया को दिखाएगी जिसके लिए कोई स्केल तय नहीं किया गया है. हालांकि, हर डाइमेंशन में दोगुनी पिक्सल होंगी. इसमें सड़कें और लेबल शामिल होते हैं, ताकि वे हाई रिज़ॉल्यूशन, छोटी साइज़ की स्क्रीन, और ब्राउज़र के ज़रिए स्केल किए जाने पर पढ़ी जा सकें.

150x150	150x150&स्केल=2

ऐसी इमेज डेस्कटॉप ब्राउज़र पर भी अच्छी तरह काम करेगी. उसे सीएसएस का इस्तेमाल करके, ऊंचाई और चौड़ाई के साथ img या div टैग में डाला जाएगा. क्वालिटी खराब हुए बिना ब्राउज़र, इमेज का साइज़ सही साइज़ तक कम कर देगा.

इस टेबल में तीन अलग-अलग इमेज अनुरोध दिखाए गए हैं.

• पहली 100x100 इमेज के लिए है, जिसमें कोई स्केल वैल्यू नहीं है. यह डेस्कटॉप पर ठीक से दिखता है, लेकिन मोबाइल डिवाइस पर इसे पढ़ने के हिसाब से बहुत छोटा है.
• दूसरे मान से मैप का साइज़ दोगुना हो जाता है. डेस्कटॉप पर, सीएसएस इसे 100x100 img एलिमेंट में फ़िट कर देती है, लेकिन इमेज को डाउनग्रेड करने पर, सड़क और लेबल बहुत छोटे हो जाते हैं. मोबाइल डिवाइस पर, इमेज सही साइज़ की है, लेकिन फिर से, सड़कों और लेबल को पढ़ा नहीं जा सकता.
• तीसरा अनुरोध scale=2 के साथ 100x100 मैप के लिए है. इमेज को 200 पिक्सल की जानकारी के साथ दिखाया जाता है; डेस्कटॉप इसे पूरी तरह से स्केल करता है, ताकि यह मूल 100x100 अनुरोध से अलग न रहे. साथ ही, मोबाइल ब्राउज़र को एपीआई से मिले अतिरिक्त रिज़ॉल्यूशन से फ़ायदा मिले.

इमेज अनुरोध
डिवाइस	100x100	200x200	100x100&scale=2
डेस्कटॉप (height="100px" और width="100px" के साथ img टैग पर)
हाई रिज़ॉल्यूशन (सिम्युलेटेड)

सलाह: Android और iOS जैसे मोबाइल प्लैटफ़ॉर्म, हर रिज़ॉल्यूशन के लिए अलग-अलग इमेज तय करके, ऐप्लिकेशन को हाई रिज़ॉल्यूशन वाली स्क्रीन पर चलने में मदद करते हैं. स्केल पैरामीटर से, सामान्य रिज़ॉल्यूशन वाली स्क्रीन के लिए मैप इमेज और ज़्यादा रिज़ॉल्यूशन वाली स्क्रीन के लिए मिलते-जुलते मैप के लिए अनुरोध करना आसान हो जाता है. इसके लिए, सिर्फ़ scale=1 और scale=2 को सेट करना होता है.

मोबाइल और हाई रिज़ॉल्यूशन वाले डिसप्ले बनाने के बारे में ज़्यादा जानकारी के लिए, नीचे दिया गया टेक्स्ट पढ़ें:

• Android डेवलपर दस्तावेज़ में, कई स्क्रीन पर काम करना.
• हाई डीपीआई वेब साइटें बनाने के लिए, Webkit.org के सुझाव.
• iOS डेवलपर लाइब्रेरी में हाई रिज़ॉल्यूशन वाली स्क्रीन पर काम करना.

इमेज फ़ॉर्मैट

इमेज कई सामान्य वेब ग्राफ़िक फ़ॉर्मैट में दी जा सकती हैं: GIF, JPEG और PNG. format पैरामीटर, इनमें से किसी एक वैल्यू का इस्तेमाल करता है:

• png8 या png (डिफ़ॉल्ट) 8-बिट PNG फ़ॉर्मैट के बारे में बताता है.
• png32 32-बिट PNG फ़ॉर्मैट के बारे में बताता है.
• gif से GIF फ़ॉर्मैट के बारे में पता चलता है.
• jpg, JPEG का कंप्रेस करने का फ़ॉर्मैट बताता है.
• jpg-baseline नॉन-प्रोग्रेसिव JPEG कंप्रेस करने का फ़ॉर्मैट बताता है.

इन उदाहरणों में gif और png फ़ॉर्मैट में मैप का अनुरोध किया गया है:

  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=gif&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=png&&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

आम तौर पर, jpg और jpg-baseline इमेज का सबसे छोटा साइज़ देते हैं. हालांकि, "लॉसी" कंप्रेशन से इमेज का साइज़ खराब हो सकता है. gif, png8, और png32 कम होने से कंप्रेस करने की सुविधा मिलती है.

ज़्यादातर JPEG इमेज प्रोग्रेसिव होती हैं, जिसका मतलब है कि वे पहले एक मोटी इमेज लोड करती हैं और ज़्यादा डेटा मिलने पर इमेज रिज़ॉल्यूशन को बेहतर बनाती हैं. इससे, इमेज को वेबपेजों में तेज़ी से लोड किया जा सकता है. फ़िलहाल, यह JPEG का सबसे ज़्यादा इस्तेमाल किया जाता है. हालांकि, JPEG के कुछ इस्तेमाल के लिए गैर-प्रोग्रेसिव (बेसलाइन) इमेज की ज़रूरत होती है. ऐसे मामलों में, हो सकता है कि आप jpg-baseline फ़ॉर्मैट का इस्तेमाल करना चाहें, जो प्रोग्रेसिव नहीं है.

मैप किस तरह का है

Maps स्टैटिक एपीआई, नीचे बताए गए फ़ॉर्मैट में मैप बनाता है:

• roadmap (डिफ़ॉल्ट) एक स्टैंडर्ड रोडमैप इमेज के बारे में बताता है, जैसा कि Google Maps की वेबसाइट पर आम तौर पर दिखाया जाता है. अगर कोई maptype वैल्यू तय नहीं है, तो Maps स्टैटिक एपीआई डिफ़ॉल्ट रूप से roadmap टाइल दिखाता है.
• satellite सेटेलाइट इमेज के बारे में पता चलता है.
• terrain, इलाके के पेड़ और पेड़-पौधों को ठीक करने से जुड़ी इमेज दिखाता है.
• hybrid से उपग्रह और रोडमैप इमेज के हाइब्रिड का पता चलता है. इसमें मुख्य सड़कों की साफ़-साफ़ लेयर और उपग्रह की इमेज में मौजूद जगहों के नाम दिखते हैं.

इस कोड के उदाहरण में, रोडमैप और इलाके के टाइप के बीच अंतर देखा जा सकता है.

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=roadmap&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=terrain&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

  

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

हाइब्रिड मैप को मिलाकर एक मैप बनाने के लिए उपग्रह की इमेज और रोडमैप की खास सुविधाओं का इस्तेमाल किया जाता है. ये उदाहरण उपग्रह और हाइब्रिड मैप प्रकार दिखाते हैं:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=satellite&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=hybrid&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

  

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

स्टाइल किए गए मैप

अपनी स्टाइल लागू करके, स्टैंडर्ड Google मैप के प्रज़ेंटेशन को अपनी पसंद के मुताबिक बनाएं. स्टाइल मैप की गाइड देखें.

मार्कर

markers पैरामीटर, जगहों के एक सेट में एक या इससे ज़्यादा मार्कर (मैप पिन) का सेट बताता है. एक markersएलान में तय किए गए हर मार्कर में एक ही विज़ुअल स्टाइल दिखना चाहिए; अगर आप अलग-अलग स्टाइल के मार्कर दिखाना चाहते हैं, तो आपको अलग-अलग स्टाइल की जानकारी वाले कई markers पैरामीटर देने होंगे.

markers पैरामीटर, इस फ़ॉर्मैट के वैल्यू असाइनमेंट (मार्कर डिस्क्रिप्टर) का सेट लेता है:

markers=markerStyles|markerLocation1| markerLocation2|... वगैरह

मार्करस्टाइल के सेट को markers एलान की शुरुआत में बताया जाता है. साथ ही, इसमें शून्य या ज़्यादा स्टाइल डिस्क्रिप्टर होते हैं, जिन्हें पाइप वर्ण (|) से अलग किया जाता है. इसके बाद, एक या ज़्यादा जगहों का सेट होता है जिन्हें पाइप वर्ण (|) से अलग किया जाता है.

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

मार्कर स्टाइल

मार्कर स्टाइल डिस्क्रिप्टर का सेट, पाइप (|) वर्ण से अलग किए गए वैल्यू असाइनमेंट की एक सीरीज़ है. यह शैली डिस्क्रिप्टर, उन मार्कर विशेषताओं में मार्कर दिखाते समय इस्तेमाल किए जाने वाले विज़ुअल एट्रिब्यूट बताता है. इन शैली डिस्क्रिप्टर में ये कुंजी/वैल्यू असाइनमेंट शामिल हैं:

• size: (ज़रूरी नहीं है) यह सेट किए गए {tiny, mid, small} में से मार्कर का साइज़ बताता है. अगर कोई size पैरामीटर सेट नहीं है, तो मार्कर अपने डिफ़ॉल्ट (सामान्य) साइज़ में दिखेगा.

• color: (ज़रूरी नहीं) 24-बिट कलर (जैसे: color=0xFFFFCC) या सेट से पहले से तय रंग {black, brown, green, purple, yellow, blue, gray, orange, red, white} के बारे में बताता है.

  ध्यान दें कि ट्रांसपैरंसी (32-बिट हैक्स कलर वैल्यू का इस्तेमाल करके तय की गई हैं) मार्कर में काम नहीं करती हैं. हालांकि, ये पाथ के लिए काम करती हैं.

• label: (ज़रूरी नहीं है) {A-Z, 0-9} सेट में से अक्षर और अंक वाले एक अपरकेस वर्ण के बारे में बताता है. एपीआई के इस वर्शन के लिए, अंग्रेज़ी के बड़े अक्षरों का इस्तेमाल करना ज़रूरी है. ध्यान दें कि सिर्फ़ वही मार्कर, mid पैरामीटर हैं जो alphanumeric-character पैरामीटर दिखा सकते हैं. tiny और small मार्कर, अक्षर और अंक नहीं दिखा सकते.

ध्यान दें: इन मार्कर का इस्तेमाल करने के बजाय, आप अपने कस्टम आइकॉन का इस्तेमाल कर सकते हैं. (ज़्यादा जानकारी के लिए, कस्टम आइकॉन देखें.)

मार्कर स्केलिंग

scale वैल्यू को मार्कर की इमेज के साइज़ से गुणा किया जाता है, ताकि मार्कर को आउटपुट के तौर पर पिक्सल में दिखाया जा सके. डिफ़ॉल्ट स्केल वैल्यू 1 है. स्वीकार की गई वैल्यू 1, 2, और 4 हैं.

स्केलिंग लागू करने के बाद, इमेज पर पिक्सल साइज़ की सीमा लागू होती है. उदाहरण के लिए, अगर मार्कर scale:2 पर सेट है, तो मार्कर, 4096 पिक्सल के ज़्यादा से ज़्यादा साइज़ से बड़ा हो सकता है. ऐसा तब होता है, जब स्केलिंग के बाद मार्कर कम होकर 4096 पिक्सल से कम हो जाए. ज़्यादा रिज़ॉल्यूशन वाले मैप दिखाते समय, मैप स्केलिंग के साथ मार्कर स्केलिंग का इस्तेमाल करें.

मार्कर स्थान

हर मार्कर डिस्क्रिप्टर में एक या ज़्यादा जगहों का सेट होना चाहिए, जो यह बताता हो कि मार्कर को मैप पर कहां रखा जाए. इन जगहों को अक्षांश/देशांतर वैल्यू या पते के तौर पर दिखाया जा सकता है. इन जगहों को पाइप वर्ण (|) का इस्तेमाल करके अलग किया गया है.

ध्यान दें: अगर आप किसी ऐसी जगह का इस्तेमाल करके मार्कर की जगह के बारे में बताना चाहते हैं जिसके लिए जियोकोडिंग की ज़रूरत होती है, तो इस तरह के अनुरोध में ज़्यादा से ज़्यादा 15 मार्कर जोड़े जा सकते हैं. जैसे: लोगों के लिए पते की स्ट्रिंग या पॉलीलाइन. यह सीमा सिर्फ़ मार्कर की उन जगहों पर लागू होती है जहां जियोकोडिंग की ज़रूरत होती है. यह अक्षांश/देशांतर निर्देशांकों द्वारा बताए गए मार्कर स्थानों पर लागू नहीं होता.

जगह के पैरामीटर से मैप पर मार्कर की जगह के बारे में पता चलता है. अगर मैप पर जगह की जानकारी मौजूद नहीं है, तो बनाई गई इमेज में वह मार्कर नहीं दिखेगा. इसके लिए, center और zoom पैरामीटर का इस्तेमाल किया जाएगा. हालांकि, अगर इन पैरामीटर की जानकारी नहीं दी जाती है, तो Maps स्टैटिक एपीआई सर्वर अपने-आप ऐसी इमेज बना देगा जिसमें, सप्लाई किए गए मार्कर होंगे. (इंप्लिसिट पोज़िशनिंग देखें.)

यहां मार्कर निशान की जानकारी दी गई है. ध्यान दें कि हम स्टाइल और तीन जगहों का एक सेट तय करते हैं:

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&size=400x400&
markers=color:blue%7Clabel:S%7C11211%7C11206%7C11222&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

अलग-अलग स्टाइल वाले मार्कर तय करने के लिए, हमें कई markers पैरामीटर देने होंगे. markers पैरामीटर का यह सेट तीन मार्कर को परिभाषित करता है: 62.107733, -145.5419 पर "S" लेबल वाला एक नीला मार्कर, "Delta जंक्शन, AK" पर एक छोटा हरा मार्कर, और "Tok, AK" पर "C" लेबल वाला एक मध्यम-पीला मार्कर. ये मार्कर इस उदाहरण में दिखाए गए हैं:

https://maps.googleapis.com/maps/api/staticmap?center=63.259591,-144.667969&zoom=6&size=400x400
&markers=color:blue%7Clabel:S%7C62.107733,-145.541936&markers=size:tiny%7Ccolor:green%7CDelta+Junction,AK
&markers=size:mid%7Ccolor:0xFFFF00%7Clabel:C%7CTok,AK"&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

पसंद के मुताबिक आइकॉन

Google के मार्कर आइकॉन का इस्तेमाल करने के बजाय, अपने कस्टम आइकॉन का इस्तेमाल किया जा सकता है. कस्टम आइकॉन के बारे में बताने के लिए, markers पैरामीटर में icon डिस्क्रिप्टर का इस्तेमाल किया जाता है. उदाहरण के लिए :

markers=icon:URLofIcon|markerLocation

यूआरएल का इस्तेमाल करके, icon के बारे में बताएं. यह यूआरएल कोड में बदला गया होना चाहिए. यूआरएल को छोटा करने वाली सेवाओं, जैसे कि https://goo.gl का इस्तेमाल किया जा सकता है. यूआरएल को छोटा करने वाली ज़्यादातर सेवाओं के लिए, यूआरएल को अपने-आप कोड में बदलने का विकल्प होता है.

कस्टम आइकॉन के लिए ऐंकर पॉइंट सेट किया जा सकता है. ऐंकर पॉइंट की मदद से, यह तय किया जाता है कि कुछ खास markers जगहों के आइकॉन को किस तरह रखा जाए. डिफ़ॉल्ट रूप से, कस्टम आइकॉन का ऐंकर पॉइंट, आइकॉन इमेज के नीचे बीच में होता है. अपने icon के साथ anchor डिस्क्रिप्टर का इस्तेमाल करके, आप कोई दूसरा ऐंकर पॉइंट बता सकते हैं. anchor को आइकॉन के x,y पॉइंट (जैसे कि 10,5) के तौर पर या anchor को, इन वैल्यू में से किसी एक का इस्तेमाल करके, पहले से तय किए गए अलाइनमेंट के तौर पर सेट करें: top, bottom, left, right, center, topleft, topright, bottomleft या bottomright. उदाहरण के लिए :

markers=anchor:bottomright|icon:URLofIcon|markerLocation1|markerLocation2

हर अनुरोध के लिए, ज़्यादा से ज़्यादा पांच कस्टम आइकॉन का इस्तेमाल किया जा सकता है. इस सीमा का यह मतलब नहीं है कि आप अपने मैप में सिर्फ़ पांच जगहों को मार्क कर सकते हैं. आपके मैप पर हर यूनीक आइकॉन का इस्तेमाल एक से ज़्यादा markers जगह के साथ किया जा सकता है.

आइकॉन का फ़ॉर्मैट:

• आइकॉन की इमेज PNG, JPEG या GIF फ़ॉर्मैट में हो सकती हैं. हालांकि, PNG भी इस्तेमाल करने का सुझाव दिया जाता है.
• आइकॉन का साइज़ ज़्यादा से ज़्यादा 4096 पिक्सल (स्क्वेयर इमेज के लिए 64x64) हो सकता है.

कस्टम आइकॉन के उदाहरण

उदाहरण 1 कस्टम आइकॉन बनाता है और ऐंकर का इस्तेमाल करके, आइकॉन को पोज़िशन करता है.

http://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=anchor:32,10%7Cicon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=anchor:topleft%7Cicon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=anchor:topright%7Cicon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY
&signature=YOUR_SIGNATURE

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

उदाहरण 2 उसी कस्टम आइकॉन को बनाता है जिसका उदाहरण 1 है, लेकिन ऐंकर का इस्तेमाल करके आइकॉन की स्थितियां सेट नहीं करता. यह ऐंकर के सबसे नीचे बीच के डिफ़ॉल्ट ऐंकर पर निर्भर होता है.

http://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=icon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=icon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=icon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

Maps स्टैटिक एपीआई पाथ

path पैरामीटर, मैप इमेज पर ओवरले करने के लिए, एक या ज़्यादा जगहों के सेट को पाथ से कनेक्ट करता है. path पैरामीटर, इस फ़ॉर्मैट की वैल्यू के असाइनमेंट (पाथ की जानकारी देने वाले) का सेट लेता है:

path=pathStyles|pathLocation1|pathLocation2|... वगैरह

ध्यान दें कि दोनों पाथ पॉइंट, पाइप वर्ण (|) का इस्तेमाल करके एक-दूसरे से अलग किए जाते हैं. इसलिए, स्टाइल और पॉइंट, दोनों से जुड़ी जानकारी को पाइप कैरेक्टर के ज़रिए अलग किया जाता है. इसलिए, स्टाइल की जानकारी को किसी भी पाथ डिस्क्रिप्टर में पहले दिखना चाहिए. जब Maps स्टैटिक स्टैटिक सर्वर को पाथ की जानकारी देने वाले एलिमेंट में कोई जगह मिलती है, तो यह माना जाता है कि दूसरे सभी पाथ पैरामीटर भी लोकेशन हैं.

पाथ स्टाइल

पाथ शैली डिस्क्रिप्टर का सेट, पाइप (|) वर्ण से अलग किए गए वैल्यू असाइनमेंट की सीरीज़ है. यह शैली डिस्क्रिप्टर, पाथ दिखाते समय इस्तेमाल किए जाने वाले विज़ुअल एट्रिब्यूट के बारे में बताता है. इन शैली के वर्णनकर्ताओं में ये कुंजी/वैल्यू असाइनमेंट शामिल होते हैं:

• weight: (ज़रूरी नहीं) पिक्सल में पाथ की मोटाई बताता है. अगर कोई weight पैरामीटर सेट नहीं है, तो पाथ अपनी डिफ़ॉल्ट मोटाई (5 पिक्सल) में दिखेगा.

• color: (ज़रूरी नहीं है) रंग को 24-बिट (उदाहरण: color=0xFFFFCC) या 32-बिट हैक्साडेसिमल वैल्यू (उदाहरण: color=0xFFFFCCFF) के तौर पर या सेट {black, brown, green, purple, yellow, blue, gray, orange, red, white} से दिखाया जाता है.

  जब कोई 32-बिट हेक्स वैल्यू दी जाती है, तो आखिरी के दो वर्ण 8-बिट ऐल्फ़ा ट्रांसपेरंसी वैल्यू को बताते हैं. यह वैल्यू, 00 (पूरी तरह से पारदर्शी) और FF (पूरी तरह से अपारदर्शी) के बीच अलग-अलग होती है. ध्यान दें कि पाथ में ट्रांसपैरंसी समर्थित हैं, हालांकि वे मार्कर के लिए समर्थित नहीं हैं.

• fillcolor: (ज़रूरी नहीं है), यह दिखाता है कि दोनों पाथ एक पॉलीगॉन के इलाके को मार्क करते हैं और उस इलाके में ओवरले के तौर पर इस्तेमाल करने के लिए, फ़िल कलर बताते हैं. यह ज़रूरी नहीं है कि इन जगहों के लिए सेट "बंद" लूप हो. Maps स्टैटिक स्टैटिक सर्वर अपने-आप पहले और आखिरी पॉइंट में शामिल हो जाएगा. हालांकि, ध्यान दें कि भरी हुई जगह के बाहर का कोई स्ट्रोक तब तक बंद नहीं होगा, जब तक खास तौर पर उसके शुरू और खत्म होने की एक ही जगह न दी गई हो.
• geodesic: (ज़रूरी नहीं है) यह बताता है कि अनुरोध किए गए पाथ को पृथ्वी की वक्रता के हिसाब से जियोडेसिक लाइन के तौर पर दिखाया जाना चाहिए. गलत होने पर, यह पाथ स्क्रीन की जगह में एक सीधी लाइन के तौर पर रेंडर होता है. डिफ़ॉल्ट रूप से, गलत पर सेट होती है.

पाथ के कुछ उदाहरण:

• पतली नीली रेखा, 50% अपारदर्शिता: path=color:0x0000ff80|weight:1
• सॉलिड रेड लाइन: path=color:0xff0000ff|weight:5
• मोटी सफ़ेद लाइन: path=color:0xffffffff|weight:10

पाथ के ये स्टाइल ज़रूरी नहीं हैं. अगर आपको डिफ़ॉल्ट एट्रिब्यूट जोड़ने हैं, तो पाथ के एट्रिब्यूट तय करने से रोका जा सकता है. ऐसे में, पाथ के बारे में बताने वाले पहले "तर्क" में, पहले घोषित पॉइंट (जगह) को शामिल नहीं किया जाएगा.

पाथ पॉइंट

पाथ बनाने के लिए, path पैरामीटर को दो या उससे ज़्यादा पॉइंट भी पास करना ज़रूरी है. फिर Maps स्टैटिक एपीआई एक तय क्रम में, उन पॉइंट के साथ पाथ कनेक्ट करेगा. हर pathPoint को | (पाइप) वर्ण से अलग करके pathDescriptor में दिखाया जाता है.

नीचे दिए गए उदाहरण में, नीले रंग के किसी पाथ की जानकारी दी गई है, जो डिफ़ॉल्ट तौर पर 50% अपारदर्शिता के साथ मुमकिन है, जो कि यूनियन स्क्वेयर एनवाई से टाइम्स स्क्वेयर, एनवाई तक है.

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

path पैरामीटर की खास बातें:

path=color:0x0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

नीचे दिए गए उदाहरण में 100% अपारदर्शिता के साथ एक ठोस लाल लाइन तय करने के बजाय, उसी पाथ के बारे में बताया गया है:

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

इस path पैरामीटर की खास बातें:

path=color:0xff0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

अगला उदाहरण, मैनहैटन में एक बहुभुज क्षेत्र को परिभाषित करता है, चौराहों की एक शृंखला को स्थानों के रूप में पास किया है:

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

इस path पैरामीटर की खास बातें:

path=color:0x00000000|weight:5|fillcolor:0xFFFF0033|8th+Avenue+%26+34th+St,New+York,NY|\
8th+Avenue+%26+42nd+St,New+York,NY|Park+Ave+%26+42nd+St,New+York,NY,NY|\
Park+Ave+%26+34th+St,New+York,NY,NY

ध्यान दें कि हम पाथ को खुद को न दिखने वाले और बहुभुज के क्षेत्र को 15% अपारदर्शिता के लिए सेट करते हैं.

एन्कोड की गई पॉलीलाइन

जगहों की सीरीज़ के बजाय, आप path के जगह के एलान में enc: प्रीफ़िक्स का इस्तेमाल करके, पाथ को एन्कोड किए गए पॉलीलाइन के तौर पर बता सकते हैं.

यहां दिए गए उदाहरण में, अलास्का हाइवे के डॉसनसन, ब्रिटिश कोलंबिया से लेकर डेल्टा जंक्शन तक के सफ़र की जानकारी दी गई है. ये एन्कोडेड पॉलीलाइन भी हैं:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=59.900503,-135.478011&zoom=4
&path=weight:3%7Ccolor:orange%7Cenc:_fisIp~u%7CU}%7Ca@pytA_~b@hhCyhS~hResU%7C%7Cx@oig@rwg@amUfbjA}f[roaAynd@%7CvXxiAt{ZwdUfbjAewYrqGchH~vXkqnAria@c_o@inc@k{g@i`]o%7CF}vXaj\h`]ovs@?yi_@rcAgtO%7Cj_AyaJren@nzQrst@zuYh`]v%7CGbldEuzd@%7C%7Cx@spD%7CtrAzwP%7Cd_@yiB~vXmlWhdPez\_{Km_`@~re@ew^rcAeu_@zhyByjPrst@ttGren@aeNhoFemKrvdAuvVidPwbVr~j@or@f_z@ftHr{ZlwBrvdAmtHrmT{rOt{Zz}E%7Cc%7C@o%7CLpn~AgfRpxqBfoVz_iAocAhrVjr@rh~@jzKhjp@``NrfQpcHrb^k%7CDh_z@nwB%7Ckb@a{R%7Cyh@uyZ%7CllByuZpzw@wbd@rh~@%7C%7CFhqs@teTztrAupHhyY}t]huf@e%7CFria@o}GfezAkdW%7C}[ocMt_Neq@ren@e~Ika@pgE%7Ci%7CAfiQ%7C`l@uoJrvdAgq@fppAsjGhg`@%7ChQpg{Ai_V%7C%7Cx@mkHhyYsdP%7CxeA~gF%7C}[mv`@t_NitSfjp@c}Mhg`@sbChyYq}e@rwg@atFff}@ghN~zKybk@fl}A}cPftcAite@tmT__Lha@u~DrfQi}MhkSqyWivIumCria@ciO_tHifm@fl}A{rc@fbjAqvg@rrqAcjCf%7Ci@mqJtb^s%7C@fbjA{wDfs`BmvEfqs@umWt_Nwn^pen@qiBr`xAcvMr{Zidg@dtjDkbM%7Cd_@
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

स्टैंडर्ड पाथ की तरह, अगर fillcolor पैरामीटर को path पैरामीटर में पास किया जाता है, तो कोड में बदले गए पॉलीलाइन पाथ से भी, पॉलीगॉन के इलाके अलग हो सकते हैं.

यहां दिए गए उदाहरण में, ब्रुकलिन, न्यूयॉर्क के लिए एक बहुभुज वाला इलाका बताया गया है:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=40.653279,-73.959816&zoom=11
&path=fillcolor:0xAA000033%7Ccolor:0xFFFFFF00%7Cenc:}zswFtikbMjJzZ%7CRdPfZ}DxWvBjWpF~IvJnEvBrMvIvUpGtQpFhOQdKpz@bIx{A%7CPfYlvApz@bl@tcAdTpGpVwQtX}i@%7CGen@lCeAda@bjA%60q@v}@rfAbjA%7CEwBpbAd_@he@hDbu@uIzWcWtZoTdImTdIwu@tDaOXw_@fc@st@~VgQ%7C[uPzNtA%60LlEvHiYyLs^nPhCpG}SzCNwHpz@cEvXg@bWdG%60]lL~MdTmEnCwJ[iJhOae@nCm[%60Aq]qE_pAaNiyBuDurAuB }}Ay%60@%7CEKv_@?%7C[qGji@lAhYyH%60@Xiw@tBerAs@q]jHohAYkSmW?aNoaAbR}LnPqNtMtIbRyRuDef@eT_z@mW_Nm%7CB~j@zC~hAyUyJ_U{Z??cPvg@}s@sHsc@_z@cj@kp@YePoNyYyb@_iAyb@gBw^bOokArcA}GwJuzBre@i\tf@sZnd@oElb@hStW{]vv@??kz@~vAcj@zKa%60Atf@uQj_Aee@pU_UrcA
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

व्यूपोर्ट

इमेज, visible पैरामीटर का इस्तेमाल करके, दिखने वाली जगहों की जानकारी देकर व्यूपोर्ट के बारे में बता सकती हैं. visible पैरामीटर, Maps स्टैटिक स्टैटिक सेवा को मैप बनाने का निर्देश देता है, ताकि मौजूदा जगहें दिख सकें. (इस पैरामीटर को मौजूदा मार्कर या पाथ के साथ जोड़कर, दिखने वाले इलाके के बारे में भी बताया जा सकता है.) इस तरीके से व्यूपोर्ट तय करने से ज़ूम का सटीक लेवल बताने की ज़रूरत नहीं होती.

अगले उदाहरण में, MA, कैमब्रिज के एमआईटी और हार्वर्ड स्क्वेयर, दोनों को ध्यान में रखकर बनाए गए एक मैप का अनुरोध किया गया है:

https://maps.googleapis.com/maps/api/staticmap?center=Boston,MA
&visible=77+Massachusetts+Ave,Cambridge,MA%7CHarvard+Square,Cambridge,MA&size=512x512&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

मैप की अस्पष्ट स्थिति

आम तौर पर, जनरेट किए गए मैप की जगह और ज़ूम का लेवल तय करने के लिए, आपको center और zoom यूआरएल पैरामीटर के बारे में बताना होगा. हालांकि, अगर आप markers, path या visible पैरामीटर देते हैं, तो Maps के स्टैटिक एपीआई का सही सेंटर तय करने और ज़ूम लेवल की जांच करने का विकल्प दिया जाता है. यह इन एलिमेंट की स्थिति के आधार पर तय किया जाता है.

अगर आप दो या उससे ज़्यादा एलिमेंट देते हैं, तो Maps स्टैटिक एपीआई सही सेंटर और ज़ूम लेवल तय करेगा, जिसमें शामिल एलिमेंट के लिए पारदर्शी मार्जिन होगा. इस उदाहरण में एक मैप दिखाया गया है, जिसमें सैन फ़्रांसिस्को, ऑकलैंड, और सैन होज़े, CA:

https://maps.googleapis.com/maps/api/staticmap?size=512x512&maptype=roadmap\
&markers=size:mid%7Ccolor:red%7CSan+Francisco,CA%7COakland,CA%7CSan+Jose,CA&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

हो सकता है कि आपके इलाके में सैंपल उपलब्ध न हों.

इमेज का साइज़ बड़ा करें

अगर आपको 640 x 640 पिक्सल (या 2 के मान के साथ 1280 x 1280 पिक्सल) से बड़े साइज़ की इमेज चाहिए, तो कृपया सहायता टीम से संपर्क करें और यह जानकारी दें:

1. आपके इस्तेमाल के उदाहरण और बड़ी साइज़ वाली इमेज की ज़रूरत क्यों.
2. आपने अन्य Google Maps Platform API (Maps JavaScript एपीआई, Maps एंबेड एपीआई, Android के लिए Maps SDK टूल, या iOS के लिए Maps SDK) का इस्तेमाल करने के बारे में सोचा है और यह भी कि वे आपकी ज़रूरतों को क्यों पूरा नहीं करते.
3. बड़े साइज़ की इमेज का इस्तेमाल करने के आपके स्क्रीनशॉट, मॉक या सैंपल.
4. बड़े साइज़ की इमेज के लिए, हर महीने का अनुमानित इस्तेमाल.

हम आपकी दी गई जानकारी के आधार पर आपके अनुरोध की समीक्षा करेंगे. साथ ही, यह तय करेंगे कि आपका इस्तेमाल का उदाहरण Google Maps Platform की सेवा की शर्तों का पालन करता है या नहीं.

हम ज़्यादा से ज़्यादा 2048 x 2048 पिक्सल का साइज़ दे सकते हैं.

समस्या हल करने का तरीका और सहायता

Maps स्टैटिक एपीआई का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, सहायता पेज देखें.

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