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
मैप पर 1x स्केल फ़ैक्टर दिखाया गया है मैप पर 2x स्केल फ़ैक्टर दिखाया गया है
highDpi
इससे पता चलता है कि हाई रिज़ॉल्यूशन वाली टाइल दिखानी हैं या नहीं. अगर स्केल-फ़ैक्टर को बढ़ाया जाता है, तो टाइल का साइज़ बढ़ाने के लिए highDpi का इस्तेमाल किया जाता है. आम तौर पर, स्केल फ़ैक्टर को बढ़ाने से, टाइल का साइज़ बड़ा हो जाता है. हालांकि, इमेज का साइज़ पहले जैसा ही रहता है. इससे इमेज की क्वालिटी कम हो जाती है. highDpi की मदद से, इमेज की क्वालिटी को बरकरार रखते हुए उसका साइज़ भी बढ़ाया जा सकता है. डीपीआई का मतलब है डॉट्स पर इंच. हाई डीपीआई का मतलब है कि टाइल को रेंडर करने के लिए, सामान्य से ज़्यादा डॉट्स पर इंच का इस्तेमाल किया जाता है. अगर true है, तो x और y डाइमेंशन में से हर एक में पिक्सल की संख्या को स्केल फ़ैक्टर (यानी कि 2x या 4x) से गुणा किया जाता है. टाइल के कवरेज एरिया में कोई बदलाव नहीं होता. यह पैरामीटर सिर्फ़ scale की 2x या 4x वैल्यू के साथ काम करता है. इसका 1x स्केल टाइल पर कोई असर नहीं पड़ता.
स्केल फ़ैक्टर 1x स्केल फ़ैक्टर 2x हाई डीपीआई
मैप को सामान्य रिज़ॉल्यूशन में दिखाया गया मैप को 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 हो सकता है.