حالت Lite

Maps SDK برای اندروید می‌تواند یک تصویر بیت مپ از یک نقشه ارائه کند و تعامل محدودی را به کاربر ارائه دهد. به این نقشه حالت لایت می گویند.

نمونه کد

مخزن ApiDemos در GitHub شامل نمونه هایی است که استفاده از حالت ساده را نشان می دهد:

• LiteDemoActivity - Java : اصول اولیه استفاده از نقشه حالت Lite در جاوا
• LiteDemoActivity - Kotlin : اصول اولیه استفاده از نقشه حالت Lite در Kotlin
• LiteListDemoActivity - Java : نمایش نقشه ها به طور موثر در ListViews با استفاده از حالت Lite در جاوا
• LiteListDemoActivity - Kotlin : نمایش نقشه ها به طور موثر در ListViews با استفاده از حالت Lite در Kotlin

نمای کلی حالت Lite

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

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

اضافه کردن یک نقشه حالت ساده

حالت 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() الزامی است، در غیر این صورت هیچ نقشه ای ظاهر نمی شود.
• اگر می‌خواهید نقطه My Location را روی نقشه حالت Lite خود نشان دهید و از منبع موقعیت مکانی پیش‌فرض استفاده کنید، باید onResume() و onPause() را فراخوانی کنید، زیرا منبع مکان فقط بین این تماس‌ها به‌روزرسانی می‌شود. اگر از منبع موقعیت مکانی خود استفاده می کنید، لازم نیست این دو روش را فراخوانی کنید.

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

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