Google Maps Platform के स्टैटिक वेब एपीआई, Google की सेवाओं के लिए एचटीटीपी इंटरफ़ेस का एक कलेक्शन है. ये इंटरफ़ेस, ऐसी इमेज जनरेट करते हैं जिन्हें सीधे तौर पर अपने वेबपेज पर एम्बेड किया जा सकता है.
इस गाइड में, इमेज के अनुरोधों को सेट अप करने और सेवा से मिले जवाबों को प्रोसेस करने के कुछ सामान्य तरीकों के बारे में बताया गया है. Maps Static API के बारे में ज़्यादा जानने के लिए, डेवलपर की गाइड देखें.
स्टैटिक वेब एपीआई क्या होता है?
Google Maps Platform के स्टैटिक वेब एपीआई की मदद से, अपने वेब पेज में Google Maps की इमेज एम्बेड की जा सकती है. इसके लिए, JavaScript या डाइनैमिक पेज लोडिंग की ज़रूरत नहीं होती. स्टैटिक वेब एपीआई, यूआरएल पैरामीटर के आधार पर इमेज बनाते हैं. इन पैरामीटर को स्टैंडर्ड एचटीटीपीएस अनुरोध का इस्तेमाल करके भेजा जाता है.
Maps Static API का सामान्य अनुरोध इस तरह का होता है:
https://www.googleapis.com/staticmap/z/x/y?parameters
ध्यान दें: Maps Static API के सभी ऐप्लिकेशन के लिए, पुष्टि करना ज़रूरी है. ज़्यादा जानकारी के लिए, पुष्टि करने के क्रेडेंशियल देखें.
TLS ऐक्सेस
Google Maps Platform के उन सभी अनुरोधों के लिए HTTPS ज़रूरी है जिनमें एपीआई पासकोड का इस्तेमाल किया जाता है या जिनमें उपयोगकर्ता का डेटा शामिल होता है. एचटीटीपी पर किए गए ऐसे अनुरोधों को अस्वीकार किया जा सकता है जिनमें संवेदनशील डेटा शामिल होता है.
मान्य यूआरएल बनाना
आपको लग सकता है कि "मान्य" यूआरएल के बारे में बताने की ज़रूरत नहीं है, लेकिन ऐसा नहीं है. ब्राउज़र के पता बार में डाला गया यूआरएल, उदाहरण के लिए, खास वर्ण (जैसे, "上海+中國") शामिल कर सकता है. ब्राउज़र को ट्रांसमिशन से पहले, उन वर्णों को किसी अन्य एन्कोडिंग में बदलना होता है.
इसी तरह, UTF-8 इनपुट जनरेट करने या स्वीकार करने वाला कोई भी कोड, UTF-8 वर्णों वाले यूआरएल को "मान्य" के तौर पर देख सकता है. हालांकि, उसे उन वर्णों को वेब सर्वर पर भेजने से पहले, उनका अनुवाद भी करना होगा.
इस प्रोसेस को
यूआरएल-कोडिंग या परसेंट-कोडिंग कहा जाता है.
विशेष वर्ण
हमें खास वर्णों का अनुवाद करने की ज़रूरत होती है, क्योंकि सभी यूआरएल को यूनिफ़ॉर्म रिसोर्स आइडेंटिफ़ायर (यूआरआई) के निर्देशों के मुताबिक सिंटैक्स का पालन करना होता है. इसका मतलब है कि यूआरएल में सिर्फ़ ASCII वर्णों का खास सबसेट होना चाहिए: जाने-पहचाने अल्फ़ान्यूमेरिक सिंबल और यूआरएल में कंट्रोल वर्णों के तौर पर इस्तेमाल किए जाने वाले कुछ रिज़र्व वर्ण. इस टेबल में इन वर्णों के बारे में खास जानकारी दी गई है:
| सेट करें | वर्ण | यूआरएल का इस्तेमाल |
|---|---|---|
| अक्षर और अंक दोनों शामिल हो सकते हैं | a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 | टेक्स्ट स्ट्रिंग, स्कीम का इस्तेमाल (http), पोर्ट (8080) वगैरह |
| गैर-आरक्षित | - _ . ~ | टेक्स्ट स्ट्रिंग |
| बुकिंग की गई | ! * ' ( ) ; : @ & = + $ , / ? % # [ ] | कंट्रोल वर्ण और/या टेक्स्ट स्ट्रिंग |
मान्य यूआरएल बनाते समय, आपको यह पक्का करना होगा कि उसमें सिर्फ़ टेबल में दिखाए गए वर्ण शामिल हों. यूआरएल में इन वर्णों का इस्तेमाल करने से आम तौर पर दो समस्याएं होती हैं. पहली समस्या में, वर्णों को हटा दिया जाता है और दूसरी समस्या में, वर्णों को बदल दिया जाता है:
- आपको जिन वर्णों को हैंडल करना है वे ऊपर दिए गए सेट से बाहर हैं. उदाहरण के लिए, विदेशी भाषाओं के वर्णों, जैसे कि
上海+中國को ऊपर दिए गए वर्णों का इस्तेमाल करके एन्कोड करना होगा. आम तौर पर, स्पेस (जिन्हें यूआरएल में इस्तेमाल करने की अनुमति नहीं है) को प्लस'+'वर्ण का इस्तेमाल करके भी दिखाया जाता है. - ऊपर दिए गए सेट में वर्ण, रिज़र्व किए गए वर्णों के तौर पर मौजूद होते हैं. हालांकि, इनका इस्तेमाल लिटरल तौर पर किया जाना चाहिए.
उदाहरण के लिए, यूआरएल में
?का इस्तेमाल क्वेरी स्ट्रिंग की शुरुआत दिखाने के लिए किया जाता है. अगर आपको "? and the Mysterions," स्ट्रिंग का इस्तेमाल करना है, तो आपको'?'वर्ण को कोड में बदलना होगा.
यूआरएल में कोड में बदले जाने वाले सभी वर्णों को '%' वर्ण और उनके UTF-8 वर्ण के हिसाब से दो वर्णों वाली हेक्स वैल्यू का इस्तेमाल करके कोड में बदला जाता है. उदाहरण के लिए,
上海+中國 को UTF-8 में यूआरएल के तौर पर कोड में बदला जाएगा. जैसे, %E4%B8%8A%E6%B5%B7%2B%E4%B8%AD%E5%9C%8B. स्ट्रिंग ? and the Mysterians को यूआरएल के हिसाब से कोड में बदलकर %3F+and+the+Mysterians या %3F%20and%20the%20Mysterians लिखा जाएगा.
ऐसे सामान्य वर्ण जिन्हें एन्कोड करने की ज़रूरत होती है
कुछ सामान्य वर्णों को कोड में बदलना ज़रूरी है. जैसे:
| असुरक्षित वर्ण | एन्कोड की गई वैल्यू |
|---|---|
| स्पेस | %20 |
| " | %22 |
| < | %3C |
| > | %3E |
| # | %23 |
| % | %25 |
| | | %7C |
उपयोगकर्ता के इनपुट से मिले यूआरएल को बदलना कभी-कभी मुश्किल होता है. उदाहरण के लिए, कोई उपयोगकर्ता पते को "5th&Main St." के तौर पर डाल सकता है. आम तौर पर, आपको अपने यूआरएल को उसके हिस्सों से बनाना चाहिए. साथ ही, उपयोगकर्ता के किसी भी इनपुट को लिटरल वर्णों के तौर पर इस्तेमाल करना चाहिए.
इसके अलावा, Google Maps Platform की सभी वेब सेवाओं और स्टैटिक वेब एपीआई के लिए, यूआरएल में ज़्यादा से ज़्यादा 16,384 वर्ण हो सकते हैं. ज़्यादातर सेवाओं के लिए, वर्णों की इस सीमा तक पहुंचने की ज़रूरत नहीं पड़ेगी. हालांकि, ध्यान दें कि कुछ सेवाओं में कई पैरामीटर होते हैं. इस वजह से, यूआरएल लंबे हो सकते हैं.