लाइट मोड

Android के लिए Maps SDK टूल, मैप की बिटमैप इमेज दिखा सकता है. इससे उपयोगकर्ता को सीमित इंटरैक्टिविटी मिलती है. इसे लाइट मोड का मैप कहा जाता है.

कोड सैंपल

GitHub पर मौजूद ApiDemos रिपॉज़िटरी में, ऐसे सैंपल शामिल हैं जिनमें लाइट मोड के इस्तेमाल के बारे में बताया गया है:

• LiteDemoActivity - Java: Java में लाइट मोड वाले मैप का इस्तेमाल करने के बुनियादी तरीके
• LiteDemoActivity - Kotlin: Kotlin में लाइट मोड वाले मैप का इस्तेमाल करने के बुनियादी तरीके
• LiteListDemoActivity - Java: Java में लाइट मोड का इस्तेमाल करके, ListViews में बेहतर तरीके से मैप दिखाना
• LiteListDemoActivity - Kotlin: Kotlin में लाइट मोड का इस्तेमाल करके, ListViews में मैप को बेहतर तरीके से दिखाना

लाइट मोड के बारे में खास जानकारी

लाइट मोड मैप, किसी तय जगह और ज़ूम लेवल पर मैप की बिटमैप इमेज होती है. लाइट मोड में, सभी तरह के मैप (सामान्य, हाइब्रिड, सैटलाइट, और टेरेन) काम करते हैं. साथ ही, इसमें एपीआई की सभी सुविधाओं का एक सबसेट भी काम करता है. लाइट मोड तब काम आता है, जब आपको स्ट्रीम में कई मैप दिखाने हों या ऐसा मैप दिखाना हो जो इंटरैक्ट करने के लिए बहुत छोटा हो.

मैप देखने वाले लोग, मैप को ज़ूम या पैन नहीं कर सकते. मैप पर मौजूद आइकॉन की मदद से, उपयोगकर्ता 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 ऑब्जेक्ट में

val options = GoogleMapOptions()
    .liteMode(true)

      

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() को कॉल करना होगा. ऐसा इसलिए, क्योंकि जगह की जानकारी का सोर्स सिर्फ़ इन कॉल के बीच अपडेट होगा. अगर आपने अपनी जगह की जानकारी के लिए कोई दूसरा सोर्स इस्तेमाल किया है, तो इन दोनों तरीकों को कॉल करना ज़रूरी नहीं है.

API की साथ काम करने वाली सुविधाएं

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