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

सेशन टोकन, डेटा का एक हिस्सा होता है ( UUID) जिसका इस्तेमाल REST कॉल में किया जाता है, ताकि सेशन—a लिंक किए गए मैसेज की सीरीज़ देखी जा सकती है. आपको सभी में सेशन टोकन शामिल करना होगा 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). टाइल के कवरेज एरिया में कोई बदलाव नहीं किया गया है. यह पैरामीटर 2x या 4x के सिर्फ़ scale वैल्यू के साथ काम करता है. इस पर कोई असर नहीं पड़ता 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 पर सेट करने से, 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
एक स्ट्रिंग, जिसमें टोकन की समयसीमा खत्म होने का समय (सेकंड में) होता है. सेशन टोकन, बनाए जाने के दो हफ़्ते बाद तक मान्य होता है समय है, लेकिन यह नीति बिना किसी सूचना के बदल सकती है.
tileWidth
पिक्सल में मापी गई टाइल की चौड़ाई.
tileHeight
पिक्सल में मापी गई टाइल की ऊंचाई.
imageFormat
इमेज फ़ॉर्मैट, जो png या jpeg हो सकता है.