Map Tiles एपीआई के साथ सेशन टोकन का इस्तेमाल करें

सेशन टोकन, डेटा का एक हिस्सा (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) से गुणा किया जाता है. टाइल के कवरेज एरिया में कोई बदलाव नहीं होता. यह पैरामीटर सिर्फ़ scale की 2x या 4x वैल्यू के साथ काम करता है. इसका 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: false	overlay: true

यहां दिए गए 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" }
      ]
    }
  ]
}

इस उदाहरण में, ऐसा ओवरले दिया गया है जिसे सैटलाइट की इमेज के साथ इस्तेमाल किया जा सकता है. उदाहरण में, रोडमैप और Street View ओवरले, दोनों शामिल हैं. नतीजे के तौर पर मिलने वाले मैप में, नाम और डेटा अंग्रेज़ी भाषा में रेंडर किया जाता है, जैसा कि अमेरिका में बोला जाता है.

सेशन टोकन रिस्पॉन्स

यहां JSON का एक उदाहरण दिया गया है.

{
  "session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
  "expiry": "1361828036",
  "tileWidth": 256,
  "tileHeight": 256,
  "imageFormat": "png"
}

यहां दी गई सूची में, रिस्पॉन्स बॉडी में मौजूद फ़ील्ड की परिभाषाएं दी गई हैं.

session

सेशन टोकन की वैल्यू, जिसे आपको Map Tiles API के सभी अनुरोधों में शामिल करना होगा.

expiry

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

tileWidth

पिक्सल में मापी गई टाइल की चौड़ाई.

tileHeight

पिक्सल में मापी गई टाइल की ऊंचाई.

imageFormat

इमेज का फ़ॉर्मैट, जो png या jpeg हो सकता है.