लाइट मोड

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

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

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