शुरू करें

शुरुआती जानकारी

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

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

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

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

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

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

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

Maps स्टैटिक API का यूआरएल इस तरह का होना चाहिए:

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

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

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

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

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

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

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

• center (अगर मार्कर मौजूद नहीं हैं, तो ज़रूरी है) मैप के केंद्र को दिखाता है. यह मैप के सभी किनारों से एक जैसे दूरी पर होता है. यह पैरामीटर, जगह की जानकारी को कॉमा से अलग किए गए {अमेरिका ज़्यादा जानकारी के लिए, जगह देखें.
• zoom (अगर मार्कर मौजूद नहीं हैं, तो ज़रूरी है) मैप के ज़ूम लेवल के बारे में बताता है. इससे, मैप का ज़ूम करने का लेवल तय होता है. यह पैरामीटर, मनचाहे इलाके के ज़ूम लेवल के हिसाब से संख्या वाली वैल्यू लेता है. ज़्यादा जानकारी के लिए, ज़ूम का लेवल देखें.

मैप के पैरामीटर

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

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

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

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

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

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

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

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

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

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

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

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

पते

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

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

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

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

यहां दिए गए उदाहरण में, बर्कले, कैलिफ़ोर्निया के लिए स्टैटिक मैप इमेज जनरेट की गई है:

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

ज़ूम लेवल

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

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

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

अगर आपने ऐसे ज़ूम लेवल के लिए अनुरोध भेजा है जिसमें कोई मैप टाइल मौजूद नहीं है, तो 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 स्टैटिक API का 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
डेस्कटॉप ( img टैग पर height="100px" और width="100px" के साथ)
हाई रिज़ॉल्यूशन (सिम्युलेटेड)

अहम जानकारी: 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 Static API नीचे दिए गए कई फ़ॉर्मैट में मैप बनाता है:

• 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 स्टैटिक API सर्वर को मार्कर डिस्क्रिप्टर में कोई जगह मिलती है, तो दूसरे सभी मार्कर पैरामीटर को भी लोकेशन माना जाता है.

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

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

• 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 पर "S" लेबल किया गया एक नीला मार्कर, -145.5419, "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) या पहले से तय अलाइनमेंट के तौर पर, इनमें से किसी एक वैल्यू का इस्तेमाल करके सेट करें: top, bottom, left, right, center, topleft, topright, bottomleft या bottomright. उदाहरण के लिए:

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

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

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

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

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

उदाहरण 1, कस्टम आइकॉन बनाता है और ऐंकर का इस्तेमाल करके आइकॉन की जगह तय करता है.

https://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 की तरह ही पसंद के मुताबिक आइकॉन बनाता है, लेकिन नीचे बीच के डिफ़ॉल्ट ऐंकर पर निर्भर करते हुए, ऐंकर का इस्तेमाल करके आइकॉन की पोज़िशन सेट नहीं करता.

https://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 स्टैटिक API सर्वर को पाथ डिस्क्रिप्टर में कोई जगह मिलती है, तो बाकी सभी पाथ पैरामीटर को भी जगह माना जाता है.

पाथ स्टाइल

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

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

• 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% ओपैसिटी (अपारदर्शिता) के लिए सेट करते हैं. वहीं, पॉलीगॉन वाले एरिया को 15% ओपैसिटी पर सेट करते हैं.

कोड में बदली गई पॉलीलाइन

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

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

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

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

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

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

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 के अन्य एपीआई (Maps JavaScript API, Maps Embed API, Android के लिए Maps SDK या iOS के लिए Maps SDK टूल) का इस्तेमाल करने के बारे में सोचा हो और वे आपकी ज़रूरतों को पूरा क्यों नहीं कर रहे हों.
3. बड़े साइज़ की इमेज का इस्तेमाल करने के तरीके के स्क्रीनशॉट, मॉक या सैंपल.
4. बड़े साइज़ की इमेज के लिए, हर महीने आपके अनुमानित खर्च की जानकारी.

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

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

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

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

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