Android के लिए Maps SDK टूल, मैप की बिट मैप इमेज दिखा सकता है. इससे, उपयोगकर्ता को सीमित जानकारी मिलती है. इसे लाइट मोड मैप कहा जाता है.
कोड सैंपल
GitHub पर ApiDemos डेटा स्टोर करने की जगह में, ऐसे सैंपल शामिल हैं जो लाइट मोड के इस्तेमाल के बारे में बताते हैं:
- LiteDemoActivity - Java: जावा में लाइट मोड मैप इस्तेमाल करने की बुनियादी बातें
- LiteDemoActivity - Kotlin: Kotlin में लाइट मोड मैप इस्तेमाल करने की बुनियादी बातें
- LiteListDemoActivity - Java: मैप को बेहतर तरीके से दिखाया जा रहा है. Java में लाइट मोड का इस्तेमाल करके, ListViews का इस्तेमाल करें'
- LiteListDemoActivity - Kotlin: मैप को बेहतर तरीके से दिखाया जा रहा है. ListViews में, Kotlin में लाइट मोड का इस्तेमाल करके
लाइट मोड की खास जानकारी
लाइट मोड वाला मैप, किसी मैप में किसी खास जगह और ज़ूम लेवल की बिट मैप इमेज होती है. लाइट मोड सभी तरह के मैप (सामान्य, हाइब्रिड, सैटलाइट, इलाके) और पूरे एपीआई से दी गई सुविधाओं के सबसेट का इस्तेमाल करता है. लाइट मोड यह विकल्प तब काम आता है, जब आपको स्ट्रीम में कई मैप उपलब्ध कराना हो या कोई ऐसा मैप बनाना हो जो बहुत छोटा हो और काम के इंटरैक्शन न कर सके.
मैप देखने वाले उपयोगकर्ता, मैप को ज़ूम या पैन नहीं कर सकते हैं. मैप पर मौजूद आइकॉन, उपयोगकर्ताओं को Google Maps के मोबाइल ऐप्लिकेशन में मैप देखने और निर्देशों का अनुरोध करने का ऐक्सेस देते हैं.
लाइट मोड का मैप जोड़ना
लाइट मोड उन्हीं क्लास और इंटरफ़ेस का इस्तेमाल करता है जिनका इस्तेमाल पूरे Google Maps Android
एपीआई में होता है. नीचे बताए गए तरीकों से GoogleMap
को लाइट मोड पर सेट किया जा सकता है:
MapView
याMapFragment
के लिए, एक्सएमएल एट्रिब्यूट के तौर पर- या
GoogleMapOptions
ऑब्जेक्ट में
MapView
या MapFragment
के लिए, एक्सएमएल एट्रिब्यूट के तौर पर
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:map="http://schemas.android.com/apk/res-auto"
android:name="com.google.android.gms.maps.MapFragment"
android:id="@+id/map"
android:layout_width="match_parent"
android:layout_height="match_parent"
map:cameraZoom="13"
map:mapType="normal"
map:liteMode="true"/>
GoogleMapOptions
ऑब्जेक्ट में
Kotlin
val options = GoogleMapOptions() .liteMode(true)
Java
GoogleMapOptions options = new GoogleMapOptions() .liteMode(true);
मैप की शुरुआती स्थिति सेट करने के बारे में जानकारी के लिए, मैप ऑब्जेक्ट की गाइड देखें.
मैप व्यू या दिशा-निर्देशों का अनुरोध लॉन्च करने की इंटेंट
मैप में सबसे नीचे दाईं ओर, डिफ़ॉल्ट रूप से आइकॉन होते हैं. इनकी मदद से, Google Maps मोबाइल ऐप्लिकेशन में मैप व्यू या रास्ते की जानकारी के अनुरोध को ऐक्सेस किया जा सकता है. UiSettings.setMapToolbarEnabled(false)
पर कॉल करके टूलबार को बंद किया जा सकता है. ज़्यादा जानकारी के लिए, टूलबार दस्तावेज़ देखें.
साथ ही, जब कोई उपयोगकर्ता मैप पर टैप करता है, तो एपीआई डिफ़ॉल्ट रूप से Google Maps मोबाइल ऐप्लिकेशन चालू कर देता है. आप GoogleMap.setOnMapClickListener()
का इस्तेमाल करके, अपना लिसनर सेट करके इसे बदल सकते हैं. आपके पास मैप पर क्लिक इवेंट को बंद करने का विकल्प भी है. इसके लिए, MapView
या MapFragment
वाले व्यू पर setClickable()
को कॉल करें. इन दो तकनीकों की जानकारी के लिए, इवेंट का दस्तावेज़ देखें.
लाइफ़ साइकल के इवेंट
एपीआई का पूरी तरह से इंटरैक्टिव मोड में इस्तेमाल करते समय, MapView
क्लास के उपयोगकर्ताओं को गतिविधि की लाइफ़ साइकल के सभी तरीकों को, MapView
क्लास में मौजूद उनसे जुड़े तरीकों पर फ़ॉरवर्ड करना होगा. लाइफ़ साइकल के तरीकों के उदाहरणों में onCreate()
, onDestroy()
, onResume()
, और onPause()
शामिल हैं.
लाइट मोड में MapView
क्लास का इस्तेमाल करते समय, लाइफ़साइकल इवेंट को फ़ॉरवर्ड करना ज़रूरी नहीं होता है. हालांकि, इन मामलों को छोड़कर:
onCreate()
पर कॉल करना ज़रूरी है, नहीं तो कोई मैप नहीं दिखेगा.- अगर आपको अपने लाइट मोड मैप पर 'मेरी जगह' का डॉट दिखाना है और जगह की डिफ़ॉल्ट जानकारी के सोर्स का इस्तेमाल करना है, तो आपको
onResume()
औरonPause()
को कॉल करना होगा. ऐसा इसलिए, क्योंकि जगह की जानकारी का सोर्स सिर्फ़ इन कॉल के बीच में अपडेट होगा. अगर जगह की जानकारी के खुद के सोर्स का इस्तेमाल किया जाता है, तो इन दोनों तरीकों को कॉल करना ज़रूरी नहीं है.
इस्तेमाल की जा सकने वाली एपीआई सुविधाएं
नीचे दी गई टेबल में, एपीआई के काम करने के तरीके के हर एरिया के लिए, लाइट मोड वाले मैप के व्यवहार के बारे में बताया गया है. अगर कोई ऐप्लिकेशन किसी ऐसे तरीके को कॉल करता है जो लाइट मोड में काम नहीं करता, तो एपीआई एक चेतावनी मैसेज लॉग करेगा.
फ़ंक्शन | |
---|---|
मैप के टाइप | क्या यह काम करता है? हां
ये मैप
टाइप, GoogleMapOptions.mapType() और
GoogleMap.setMapType() के ज़रिए उपलब्ध हैं: MAP_TYPE_NORMAL ,
MAP_TYPE_SATELLITE , MAP_TYPE_TERRAIN ,
MAP_TYPE_HYBRID , MAP_TYPE_NONE |
पॉलीलाइन, पॉलीगॉन, सर्कल | क्या यह काम करता है? हां
आकार के लिए लाइट मोड की सुविधा, पूरे एपीआई से मेल खाती है. |
अनुमान की रिपोर्ट | क्या यह काम करता है? हां
Projection
के लिए, लाइट मोड की सुविधा, पूरे एपीआई से मेल खाती है. |
मेरी जगह की जानकारी | क्या यह काम करता है? हां
मेरी जगह की जानकारी की लेयर
के लाइट मोड की सुविधा, पूरे एपीआई से मेल खाती है. |
मैप पैडिंग | क्या यह काम करता है? हां
मैप पैडिंग के लिए
लाइट मोड सपोर्ट, पूरे एपीआई से मेल खाता है. |
जानकारी विंडो | क्या यह काम करता है? हां
अगर मार्कर का title() सेट किया जाता है, तो जब उपयोगकर्ता मार्कर को टैप करेगा, तब डिफ़ॉल्ट
जानकारी विंडो दिखेगी. मार्कर पर showInfoWindow() को कॉल करके,
जानकारी विंडो को प्रोग्राम के हिसाब से दिखाया जा सकता है.
InfoWindowAdapter इंटरफ़ेस के ज़रिए, पसंद के मुताबिक जानकारी वाली विंडो भी बनाई जा सकती हैं. |
बुनियादी मैप की पसंद के मुताबिक स्टाइल | क्या यह काम करता है? कुछ हद तक
Android के लिए, Maps SDK टूल पर, बुनियादी मैप की
पसंद के मुताबिक स्टाइल
की जा सकती है. लाइट मोड सिर्फ़ JSON पर आधारित कस्टम स्टाइल के साथ काम करता है, न कि क्लाउड-आधारित स्टाइल पर. स्टाइल वाले मैप को रेंडर करने के लिए, मैप आईडी की ज़रूरत होती है. |
मार्कर | क्या यह काम करता है? कुछ हद तक
आपके पास मार्कर जोड़ने और क्लिक इवेंट का जवाब देने का विकल्प है. आपके पास कस्टम मार्कर आइकॉन जोड़ने का विकल्प भी है. मार्कर को खींचने और छोड़ने लायक नहीं बनाया जा सकता. लाइट मोड वाले मैप पर मौजूद मार्कर सपाट होते हैं और इन्हें घुमाया नहीं जा सकता. |
कैमरे की स्थिति, ज़ूम, और ऐनिमेशन | क्या यह काम करता है? कुछ हद तक
आपके पास कैमरा टारगेट सेट करने और ज़ूम करने का विकल्प होता है, लेकिन टिल्ट या बेयरिंग का नहीं.
लाइट मोड में ज़ूम लेवल, सबसे नज़दीक वाले पूर्णांक में बदल जाता है.
|
इवेंट मैप करना | क्या यह काम करता है? कुछ हद तक
लाइट मोड में,
लाइट मोड में मैप पर क्लिक इवेंट को बंद करने के लिए, ज़्यादा जानकारी के लिए, इवेंट दस्तावेज़ देखें. |
इनडोर मैप और बिल्डिंग | क्या यह काम करता है? नहीं
लाइट मोड में वही टाइल दिखेंगी जो Maps Static API में दिखती हैं.
इसका मतलब है कि अगर इनडोर फ़्लोर प्लान, डिफ़ॉल्ट टाइल में बनाया गया है, तो यह दिखेगी. ऐसा नहीं करने पर, ऐसा नहीं होगा. इसके अलावा, दिखाए गए लेवल को
नहीं बदला जा सकता और न ही लेवल पिकर में बदलाव किया जा सकता है. |
ट्रैफ़िक लेयर | क्या यह काम करता है? नहीं
लाइट मोड में GoogleMap.setTrafficEnabled() काम नहीं करता. |
ग्राउंड ओवरले | क्या यह काम करता है? नहीं
GoogleMap.addGroundOverlay() , लाइट
मोड में काम नहीं करता. |
टाइल ऊपर लगाएं | क्या यह काम करता है? नहीं
GoogleMap.addTileOverlay() , लाइट
मोड में काम नहीं करता. |
हाथ के जेस्चर | क्या यह काम करता है? नहीं
लाइट मोड में हाथ के जेस्चर काम नहीं करते. हाथ के जेस्चर को चालू और बंद करने से
कोई असर नहीं पड़ेगा. |
स्ट्रीट व्यू | क्या यह काम करता है? नहीं
Street View
लाइट मोड में काम नहीं करता. |