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

सेशन टोकन, डेटा का एक हिस्सा होता है ( UUID) जिसका इस्तेमाल REST कॉल में किया जाता है, ताकि सेशन—a लिंक किए गए ईमेल मैसेज की सीरीज़ देखी जा सकती है. आपको सभी में सेशन टोकन शामिल करना होगा 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 स्केल टाइल.

स्केल फ़ैक्टर 1x	स्केल फ़ैक्टर 2x हाई डीपीआई

layerTypes

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

layerRoadmap

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

layerStreetview

यह दिखाता है कि Street View की सुविधा चालू है या नहीं. इसके तहत, सड़कों और जगहों को दिखाने के लिए, मैप.

layerTraffic

ट्रैफ़िक की मौजूदा स्थितियों की जानकारी देता है.

styles

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

overlay

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

उदाहरण के लिए, layerRoadmap लेयर के साथ satellite मैप टाइप का अनुरोध करना और overlay को false पर सेट करने से, hybrid मैप टाइप के बराबर टाइल में नतीजे मिलते हैं का इस्तेमाल Maps JavaScript API में किया गया है (बाईं इमेज). एक जैसा मैप और लेयर टाइप को 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 हो सकता है.