โหมด Lite

Maps SDK สำหรับ Android สามารถแสดงรูปภาพแผนที่แบบบิตแมป ซึ่งให้ประสบการณ์การโต้ตอบแบบจำกัดแก่ผู้ใช้ แผนที่นี้เรียกว่าแผนที่โหมด Lite

ตัวอย่างโค้ด

ที่เก็บ ApiDemos ใน GitHub มีตัวอย่างที่สาธิตการใช้โหมด Lite ดังนี้

• LiteDemoActivity - Java: พื้นฐานในการใช้แผนที่โหมด Lite ใน Java
• LiteDemoActivity - Kotlin: พื้นฐานในการใช้แผนที่โหมด Lite ใน Kotlin
• LiteListDemoActivity - Java: แสดงแผนที่อย่างมีประสิทธิภาพใน ListView โดยใช้โหมด Lite ใน Java
• LiteListDemoActivity - Kotlin: แสดงแผนที่อย่างมีประสิทธิภาพใน ListView โดยใช้โหมด Lite ใน Kotlin

ภาพรวมของโหมด Lite

แผนที่โหมด Lite คือภาพบิตแมปของแผนที่ในตำแหน่งและระดับการซูมที่ระบุ โหมด Lite รองรับแผนที่ทุกประเภท (ปกติ ไฮบริด ดาวเทียม ภูมิประเทศ) และฟังก์ชันการทำงานบางส่วนที่ API แบบสมบูรณ์มีให้ โหมด Lite มีประโยชน์เมื่อคุณต้องการแสดงแผนที่หลายรายการในสตรีม หรือแผนที่มีขนาดเล็กเกินกว่าที่จะรองรับการโต้ตอบที่มีความหมาย

ผู้ใช้ที่ดูแผนที่จะซูมหรือเลื่อนแผนที่ไม่ได้ ไอคอนบนแผนที่ช่วยให้ผู้ใช้ดูแผนที่ในแอป Google Maps บนอุปกรณ์เคลื่อนที่และขอเส้นทางได้

การเพิ่มแผนที่โหมด Lite

โหมด Lite ใช้คลาสและอินเทอร์เฟซเดียวกับ Google Maps Android API แบบเต็ม คุณตั้งค่า 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);

      

โปรดดูรายละเอียดเกี่ยวกับการตั้งค่าสถานะเริ่มต้นของแผนที่ในคู่มือออบเจ็กต์แผนที่

Intents เพื่อเปิดมุมมองแผนที่หรือคำขอเส้นทาง

โดยค่าเริ่มต้น แถบเครื่องมือที่ด้านขวาล่างของแผนที่จะมีไอคอนที่ให้สิทธิ์เข้าถึงมุมมองแผนที่หรือคำขอเส้นทางในแอป Google Maps บนอุปกรณ์เคลื่อนที่ คุณสามารถปิดใช้แถบเครื่องมือได้โดยเรียกใช้ UiSettings.setMapToolbarEnabled(false) ดูรายละเอียดเพิ่มเติมได้ที่เอกสารประกอบของแถบเครื่องมือ

นอกจากนี้ โดยค่าเริ่มต้นเมื่อผู้ใช้แตะแผนที่ API จะเปิดแอป Google Maps บนอุปกรณ์เคลื่อนที่ คุณสามารถลบล้างการตั้งค่านี้ได้โดยใช้ GoogleMap.setOnMapClickListener() เพื่อตั้งค่า Listener ของคุณเอง นอกจากนี้ คุณยังปิดใช้เหตุการณ์การคลิกบนแผนที่ได้ด้วย โดยเรียกใช้ setClickable() ในมุมมองที่มี MapView หรือ MapFragment ดูรายละเอียดของเทคนิคทั้ง 2 อย่างนี้ได้ที่เอกสารประกอบเกี่ยวกับเหตุการณ์

เหตุการณ์ในวงจรของลูกค้า

เมื่อใช้ API ในโหมดอินเทอร์แอกทีฟทั้งหมด ผู้ใช้คลาส MapView ต้องส่งต่อเมธอดวงจรชีวิตของกิจกรรมทั้งหมดไปยังเมธอดที่เกี่ยวข้องในคลาส MapView ตัวอย่างเมธอดวงจร ได้แก่ onCreate(), onDestroy(), onResume() และ onPause()

เมื่อใช้คลาส MapView ในโหมด Lite การส่งต่อเหตุการณ์ในวงจรของลูกค้าเป็นตัวเลือกที่ไม่บังคับ ยกเว้นในสถานการณ์ต่อไปนี้

• คุณต้องเรียกใช้ onCreate() มิฉะนั้นแผนที่จะไม่ปรากฏ
• หากต้องการแสดงจุด "ตำแหน่งของฉัน" ในแผนที่โหมด Lite และใช้แหล่งข้อมูลตำแหน่งเริ่มต้น คุณจะต้องเรียกใช้ onResume() และ onPause() เนื่องจากแหล่งข้อมูลตำแหน่งจะอัปเดตระหว่างการเรียกใช้เหล่านี้เท่านั้น หากใช้แหล่งที่มาของตำแหน่งของคุณเอง คุณไม่จำเป็นต้องเรียกใช้ 2 วิธีนี้

ฟีเจอร์ API ที่รองรับ

ตารางต่อไปนี้อธิบายลักษณะการทํางานของแผนที่โหมด Lite สําหรับแต่ละด้านของฟังก์ชันการทํางานของ API หากแอปเรียกใช้เมธอดที่โหมด Lite ไม่รองรับ API จะบันทึกข้อความเตือน