लाइट मोड

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

कोड सैंपल

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

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

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

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

मैप देखने वाले लोग, मैप को ज़ूम या पैन नहीं कर सकते. मैप पर मौजूद आइकॉन की मदद से, उपयोगकर्ता Google Maps मोबाइल ऐप्लिकेशन में मैप देख सकते हैं और दिशा-निर्देशों का अनुरोध कर सकते हैं.

लाइट मोड मैप जोड़ना

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

एपीआई की ये सुविधाएं इस्तेमाल की जा सकती हैं

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