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