حالت Lite

کیت توسعه نرم‌افزار نقشه‌های اندروید (Maps SDK) می‌تواند یک تصویر بیت‌مپ از نقشه را ارائه دهد و تعامل محدودی را برای کاربر فراهم کند. به این حالت، نقشه حالت سبک (Lite Mode Map) گفته می‌شود.

نمونه‌های کد

مخزن ApiDemos در گیت‌هاب شامل نمونه‌هایی است که استفاده از حالت Lite را نشان می‌دهند:

• LiteDemoActivity - جاوا : اصول اولیه استفاده از نقشه حالت Lite در جاوا
• LiteDemoActivity - کاتلین : اصول اولیه استفاده از نقشه حالت لایت در کاتلین
• LiteListDemoActivity - جاوا : نمایش کارآمد نقشه‌ها در ListViewها با استفاده از حالت Lite در جاوا
• LiteListDemoActivity - Kotlin : نمایش کارآمد نقشه‌ها در ListViewها با استفاده از حالت Lite در Kotlin

نمای کلی حالت ساده

نقشه حالت Lite، یک تصویر بیت‌مپ از یک نقشه در یک مکان مشخص و سطح بزرگنمایی است. حالت Lite از همه انواع نقشه (معمولی، ترکیبی، ماهواره‌ای، زمینی) و زیرمجموعه‌ای از قابلیت‌های ارائه شده توسط API کامل پشتیبانی می‌کند. حالت Lite زمانی مفید است که می‌خواهید تعدادی نقشه را در یک جریان ارائه دهید، یا نقشه‌ای که برای پشتیبانی از تعامل معنادار بسیار کوچک است.

کاربرانی که نقشه را مشاهده می‌کنند نمی‌توانند بزرگنمایی یا حرکت افقی روی نقشه داشته باشند. نمادهای روی نقشه به کاربران امکان مشاهده نقشه در برنامه تلفن همراه Google Maps و درخواست مسیر را می‌دهند.

اضافه شدن نقشه حالت Lite

حالت Lite از همان کلاس‌ها و رابط‌های کاربری API کامل Google Maps Android استفاده می‌کند. می‌توانید GoogleMap به روش‌های زیر روی حالت Lite تنظیم کنید:

• یا به عنوان یک ویژگی XML برای MapView یا MapFragment
• یا در شیء GoogleMapOptions

به عنوان یک ویژگی XML برای 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) غیرفعال کنید. برای جزئیات بیشتر، به مستندات نوار ابزار مراجعه کنید.

همچنین به طور پیش‌فرض وقتی کاربر روی نقشه ضربه می‌زند، API برنامه موبایل Google Maps را اجرا می‌کند. می‌توانید با استفاده از GoogleMap.setOnMapClickListener() برای تنظیم شنونده خودتان، این مورد را لغو کنید. همچنین می‌توانید با فراخوانی setClickable() در نمایی که شامل MapView یا MapFragment است، رویدادهای کلیک روی نقشه را غیرفعال کنید. برای جزئیات بیشتر در مورد این دو تکنیک، به مستندات رویدادها مراجعه کنید.

رویدادهای چرخه حیات

هنگام استفاده از API در حالت کاملاً تعاملی ، کاربران کلاس MapView باید تمام متدهای چرخه حیات فعالیت را به متدهای مربوطه در کلاس MapView ارسال کنند. نمونه‌هایی از متدهای چرخه حیات شامل onCreate() ، onDestroy() ، onResume() و onPause() هستند.

هنگام استفاده از کلاس MapView در حالت ساده ، ارسال رویدادهای چرخه عمر اختیاری است، به جز شرایط زیر:

• فراخوانی onCreate() الزامی است، در غیر این صورت هیچ نقشه‌ای نمایش داده نخواهد شد.
• اگر می‌خواهید نقطه «موقعیت مکانی من» را روی نقشه حالت ساده خود نشان دهید و از منبع موقعیت مکانی پیش‌فرض استفاده کنید، باید onResume() و onPause() را فراخوانی کنید، زیرا منبع موقعیت مکانی فقط بین این فراخوانی‌ها به‌روزرسانی می‌شود. اگر از منبع موقعیت مکانی خودتان استفاده می‌کنید، فراخوانی این دو متد ضروری نیست.

ویژگی‌های API پشتیبانی‌شده

جدول زیر رفتار یک نقشه حالت Lite را برای هر بخش از عملکرد API شرح می‌دهد. اگر برنامه‌ای متدی را فراخوانی کند که در حالت Lite پشتیبانی نمی‌شود، API یک پیام هشدار ثبت می‌کند.