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

सेशन टोकन, डेटा का एक हिस्सा (UUID) होता है. इसका इस्तेमाल REST कॉल में किसी सेशन की पहचान करने के लिए किया जाता है. यह मिलते-जुलते मैसेज एक्सचेंज की सीरीज़ होती है. आपको 2D टाइल और Street View की तस्वीरों के लिए सभी अनुरोधों में, सेशन टोकन शामिल करना होगा. आपको इसे सभी अनुरोध यूआरएल के साथ जोड़े गए, session पैरामीटर की वैल्यू के तौर पर शामिल करना होता है.

Map Tiles API में, सेशन टोकन डिसप्ले विकल्पों का तय सेट दिखाता है. इसका मतलब है कि आपको हर टाइल अनुरोध के साथ, डिसप्ले विकल्पों के सेट को पास करने की ज़रूरत नहीं है. एक ही सेशन टोकन को कई क्लाइंट के साथ इस्तेमाल किया जा सकता है. मौजूदा समय में सेशन टोकन, जारी होने की तारीख से दो हफ़्ते के लिए मान्य होता है, लेकिन यह समय बदल सकता है. जवाब वाले मैसेज में expiry फ़ील्ड को देखकर, किसी भी समय सेशन टोकन की समयसीमा खत्म होने का समय देखा जा सकता है.

ध्यान दें: 2D टाइल और Street View टाइल पाने के लिए, आपको सेशन टोकन का इस्तेमाल करना होगा, 3D टाइल पाने के लिए नहीं.

सेशन के लिए टोकन का अनुरोध

सेशन टोकन का अनुरोध करने के लिए, 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	स्केल फ़ैक्टर 2x हाई डीपीआई

layerTypes

वैल्यू का कलेक्शन, जो मैप में जोड़े गए लेयर टाइप के बारे में बताता है. मान्य वैल्यू ये हैं:

layerRoadmap

अगर आप मैप के प्रकार के तौर पर terrain को बताते हैं, तो यह ज़रूरी है. वैकल्पिक तौर पर, इसे satellite मैप टाइप पर ओवरलैप भी किया जा सकता है. इससे रोडमैप की टाइल पर कोई असर नहीं पड़ता.

layerStreetview

मैप पर नीले रंग की आउटलाइन का इस्तेमाल करके, Street View की सुविधा वाली सड़कों और जगहों को दिखाता है.

layerTraffic

ट्रैफ़िक की मौजूदा स्थिति दिखाता है.

styles

JSON शैली के ऑब्जेक्ट का कलेक्शन, जो मैप की सुविधाओं के दिखने का तरीका और जानकारी के लेवल के बारे में बताता है, जैसे कि सड़कें, पार्क, और आस-पास की जगहें. स्टाइलिंग का इस्तेमाल स्टैंडर्ड Google बेस मैप को पसंद के मुताबिक बनाने के लिए किया जाता है. styles पैरामीटर सिर्फ़ तब मान्य होता है, जब मैप टाइप roadmap हो. पूरे स्टाइल सिंटैक्स के लिए, स्टाइल रेफ़रंस देखें.

overlay

एक बूलियन वैल्यू जो यह तय करती है कि layerTypes को एक अलग ओवरले के तौर पर रेंडर करना चाहिए या उसे बेस तस्वीरों के साथ जोड़ना चाहिए. true होने पर, बुनियादी मैप नहीं दिखाया जाता है. अगर आपने कोई layerTypes तय नहीं किया है, तो इस वैल्यू को अनदेखा कर दिया जाता है.

उदाहरण के लिए, layerRoadmap लेयर के साथ satellite मैप टाइप और false पर सेट overlay का अनुरोध करने पर, 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 हो सकता है.