โหมด Lite

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

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

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

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

ภาพรวมของโหมด 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

GoogleMapOptions options = new GoogleMapOptions()
    .liteMode(true);

      

val options = GoogleMapOptions()
    .liteMode(true)

      

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

เจตจํานงที่จะเปิดมุมมองแผนที่หรือคําขอเส้นทาง

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

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

เหตุการณ์ในวงจร

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

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

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

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

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