सेशन टोकन, डेटा का एक हिस्सा (UUID) होता है. इसका इस्तेमाल REST कॉल में, किसी सेशन की पहचान करने के लिए किया जाता है. यह एक-दूसरे से जुड़े मैसेज एक्सचेंज की सीरीज़ होती है. आपको 2D टाइल और Street View की तस्वीरों के संग्रह के लिए, सभी अनुरोधों में सेशन टोकन शामिल करना होगा.
इसे session
पैरामीटर की वैल्यू के तौर पर शामिल किया जा सकता है. यह वैल्यू, अनुरोध के सभी यूआरएल से जुड़ी होती है.
Map Tiles API में, सेशन टोकन, डिसप्ले विकल्पों का तय सेट दिखाता है. इसका मतलब है कि आपको टाइल के हर अनुरोध के साथ, डिसप्ले के अलग-अलग विकल्पों को पास करने की ज़रूरत नहीं है. एक ही सेशन टोकन का इस्तेमाल एक से ज़्यादा क्लाइंट के लिए किया जा सकता है.
फ़िलहाल, कोई सेशन टोकन जारी होने के दो हफ़्ते बाद तक मान्य रहता है. हालांकि, इस समय में बदलाव हो सकता है. रिस्पॉन्स मैसेज में expiry
फ़ील्ड को देखकर, सेशन टोकन की समयसीमा खत्म होने का समय कभी भी देखा जा सकता है.
सेशन टोकन के लिए अनुरोध
सेशन टोकन का अनुरोध करने के लिए, createSession
एंडपॉइंट पर एचटीटीपीएस पोस्ट अनुरोध भेजें, जैसा कि इस उदाहरण में दिखाया गया है. आपको Content-Type: application/json
हेडर के साथ अनुरोध भेजना होगा.
curl -X POST -d '{ "mapType": "streetview", "language": "en-US", "region": "US" }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"
ज़रूरी फ़ील्ड
mapType
बेस मैप का टाइप. यह वैल्यू, इनमें से कोई एक हो सकती है:
roadmap
- Google Maps की स्टैंडर्ड टाइल, पेंट की गई मैप टाइल होती हैं.
satellite
- सैटलाइट से ली गई तस्वीरें.
terrain
- इलाके की तस्वीरें.
terrain
को मैप टाइप के तौर पर चुनते समय, आपकोlayerRoadmap
लेयर टाइप भी शामिल करना होगा. इस बारे में वैकल्पिक फ़ील्ड सेक्शन में बताया गया है. streetview
- Street View के पैनोरामा. ज़्यादा जानकारी के लिए, Street View टाइल देखें.
language
आईईटीएफ़ भाषा का टैग यह टाइल पर जानकारी दिखाने के लिए इस्तेमाल की जाने वाली भाषा के बारे में बताता है. उदाहरण के लिए,
en-US
वही अंग्रेज़ी भाषा बताता है जो अमेरिका में बोली जाती है.region
कॉमन लोकल डेटा रिपॉज़िटरी क्षेत्र का आइडेंटिफ़ायर (दो बड़े अक्षरों वाला), जो उपयोगकर्ता की जगह की जानकारी देता है. उदाहरण के लिए,
US
.
वैकल्पिक फ़ील्ड
imageFormat
- यह तय करता है कि फ़ाइल किस फ़ॉर्मैट में दिखेगी. मान्य मान या तो
jpeg
याpng
हैं. JPEG फ़ाइलों में पारदर्शिता की सुविधा काम नहीं करती है. इसलिए, ओवरले टाइल के लिए इन फ़ाइलों का सुझाव नहीं दिया जाता है. अगरimageFormat
की जानकारी नहीं दी जाती है, तो टाइल के लिए सबसे अच्छा फ़ॉर्मैट अपने-आप चुन लिया जाता है. scale
डिफ़ॉल्ट टाइल की टाइल के साइज़ और कवरेज एरिया को बनाए रखते हुए, मैप के एलिमेंट (जैसे कि सड़क के लेबल) के साइज़ को स्केल-अप करता है. स्केल बढ़ाने से मैप पर लेबल की संख्या भी कम हो जाती है, जिससे ग़ैर-ज़रूरी चीज़ें कम हो जाती हैं. ये वैल्यू,
scale
की मान्य वैल्यू हैं:scaleFactor1x
: डिफ़ॉल्ट.scaleFactor2x
: यह लेबल के साइज़ को दोगुना कर देता है. साथ ही, छोटे-छोटे फ़ीचर लेबल हटा देता है.scaleFactor4x
: लेबल के साइज़ को दोगुना कर दिया जाता है और छोटे-छोटे फ़ीचर लेबल हटा दिए जाते हैं.
नीचे दिए गए उदाहरणों में, मैप के एलिमेंट को स्केल करने का असर दिखाया गया है.
स्केल फ़ैक्टर 1x | स्केल फ़ैक्टर 2x |
---|---|
highDpi
- यह तय करता है कि हाई रिज़ॉल्यूशन वाली टाइल दिखानी हैं या नहीं. अगर स्केल-फ़ैक्टर बढ़ता है, तो टाइल का साइज़ बढ़ाने के लिए
highDpi
का इस्तेमाल किया जाता है. आम तौर पर, स्केल फ़ैक्टर को बढ़ाने पर, टाइल पर नतीजे के तौर पर मौजूद टाइल, उसके साइज़ के बराबर हो जाती है. इससे क्वालिटी खराब हो जाती है.highDpi
के साथ, वीडियो का साइज़ भी बढ़ जाता है, जिससे क्वालिटी बनी रहती है. डीपीआई का मतलब है, डॉट प्रति इंच. हाई डीपीआई का मतलब है कि टाइल रेंडर होने में सामान्य से ज़्यादा डॉट प्रति इंच इस्तेमाल होती है. अगरtrue
है, तो हर x और y डाइमेंशन में पिक्सल की संख्या को स्केल फ़ैक्टर (यानी , 2x या 4x) से गुणा किया जाता है. टाइल के कवरेज एरिया में कोई बदलाव नहीं किया गया है. यह पैरामीटर 2x या 4x के सिर्फ़scale
वैल्यू के साथ काम करता है. इससे 1x स्केल टाइल पर कोई असर नहीं पड़ता.
स्केल फ़ैक्टर 1x | स्केल फ़ैक्टर 2x हाई डीपीआई |
---|---|
layerTypes
वैल्यू का कलेक्शन, जो मैप में जोड़े गए लेयर टाइप के बारे में बताता है. मान्य वैल्यू ये हैं:
layerRoadmap
- अगर आप
terrain
को मैप टाइप के तौर पर बताते हैं, तो यह ज़रूरी है. इसेsatellite
मैप टाइप पर भी ओवरले किया जा सकता है. रोडमैप टाइल पर कोई असर नहीं पड़ता. layerStreetview
- मैप पर नीली आउटलाइन का इस्तेमाल करके, Street View की सुविधा वाली सड़कों और जगहों की जानकारी दिखाता है.
layerTraffic
- ट्रैफ़िक की मौजूदा स्थितियों की जानकारी देता है.
styles
JSON स्टाइल के ऑब्जेक्ट का कलेक्शन, जो मैप की सुविधाओं के लुक और उनकी जानकारी के लेवल के बारे में बताता है. जैसे, सड़कें, पार्क, और आस-पास बनी जगहें. स्टाइल का इस्तेमाल, Google के स्टैंडर्ड मैप को पसंद के मुताबिक बनाने के लिए किया जाता है.
styles
पैरामीटर सिर्फ़ तब मान्य होता है, जब मैप का टाइपroadmap
हो. स्टाइल के पूरे सिंटैक्स के लिए, स्टाइल का रेफ़रंस देखें.overlay
एक बूलियन वैल्यू, जिससे यह तय होता है कि
layerTypes
को अलग ओवरले के तौर पर रेंडर किया जाना चाहिए या बेस तस्वीरों के साथ जोड़ा जाना चाहिए.true
का इस्तेमाल करने पर, बुनियादी मैप नहीं दिखता. अगर आपने कोईlayerTypes
तय नहीं किया है, तो इस वैल्यू को अनदेखा कर दिया जाता है.
उदाहरण के लिए, layerRoadmap
लेयर के साथ satellite
मैप टाइप का अनुरोध करने और
overlay
को false
पर सेट करने का नतीजा यह होता है कि नतीजे, Maps JavaScript API में इस्तेमाल किए गए hybrid
मैप टाइप
के बराबर टाइल के तौर पर दिखेंगे (बाईं इमेज). जिन मैप और लेयर टाइप को overlay
true
पर सेट किया जाता है वे पारदर्शी टाइल बनाते हैं. इनमें मैप ओवरले होता है. इसे सैटलाइट से ली गई तस्वीरों (दाईं इमेज) के ऊपर लगाने के लिए, सही तरीके से स्टाइल किया जाता है.
overlay : गलत |
overlay : सही |
---|---|
यहां दिया गया JSON, अनुरोध के सामान्य मुख्य हिस्से का उदाहरण है. इसमें ज़रूरी और वैकल्पिक, दोनों फ़ील्ड शामिल हैं.
{
"mapType": "satellite",
"language": "en-US",
"region": "us",
"layerTypes": [ "layerRoadmap", "layerStreetview" ],
"overlay": true,
"scale": "scaleFactor1x",
"styles": [
{
"stylers": [
{ "hue": "#00ffe6" },
{ "saturation": -20 }
]
},{
"featureType": "road",
"elementType": "geometry",
"stylers": [
{ "lightness": 100 },
{ "visibility": "simplified" }
]
}
]
}
इस उदाहरण में एक ऐसा ओवरले दिया गया है जो सैटलाइट से ली गई तस्वीरों के साथ मिलाने के लिए सही है. उदाहरण में रोडमैप और स्ट्रीट व्यू ओवरले, दोनों शामिल हैं. नतीजे के तौर पर बने मैप को अंग्रेज़ी भाषा में नाम और डेटा के साथ रेंडर किया जाता है, क्योंकि इसे अमेरिका में बोला जाता है.
apiOptions
: वैल्यू का कलेक्शन, जिसमें लागू किए जाने वाले अतिरिक्त विकल्प बताए गए हैं.
इन विकल्पों का इस्तेमाल किया जा सकता है:
MCYJ5E517XR2JC
- मैप की नई स्टाइल के लिए ऑप्ट-इन करें. अगर ऑप्ट-इन करने की अवधि के दौरान यह वैल्यू नहीं बताई जाती, तो आपके अनुरोधों में मौजूदा स्टाइल ही दिखेगा.
सेशन टोकन रिस्पॉन्स
यह JSON, रिस्पॉन्स का मुख्य हिस्सा उदाहरण के तौर पर दिया गया है.
{
"session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
"expiry": "1361828036",
"tileWidth": 256,
"tileHeight": 256,
"imageFormat": "png"
}
इस सूची में, रिस्पॉन्स के मुख्य हिस्से में मौजूद फ़ील्ड की परिभाषाएं दी गई हैं.
session
- सेशन टोकन की वैल्यू, जिसे आपको Map Tiles API के अपने सभी अनुरोधों में शामिल करना होगा.
expiry
- ऐसी स्ट्रिंग जिसमें टोकन की समयसीमा खत्म होने का समय (epoch के बाद से सेकंड में) शामिल होता है. सेशन टोकन, बनाए जाने के समय से दो हफ़्तों तक मान्य रहता है. हालांकि, इस नीति को बिना किसी सूचना के बदला जा सकता है.
tileWidth
- पिक्सल में मापी गई टाइल की चौड़ाई.
tileHeight
- पिक्सल में मापी गई टाइल की ऊंचाई.
imageFormat
- इमेज फ़ॉर्मैट, जो
png
याjpeg
हो सकता है.