โหมด 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);

      

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

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

โดยค่าเริ่มต้น แถบเครื่องมือที่ด้านขวาล่างของแผนที่จะมีไอคอนที่ ให้การเข้าถึงมุมมองแผนที่หรือคำขอเส้นทางใน 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() มิฉะนั้นแผนที่จะไม่ปรากฏ
• หากคุณต้องการแสดงจุดตำแหน่งของฉันบนแผนที่โหมดไลท์และใช้ แหล่งที่มาของตำแหน่งเริ่มต้น คุณจะต้องโทรหา onResume() และ onPause() เพราะแหล่งที่มาของตำแหน่งจะอัปเดตในระหว่างการโทรเหล่านี้เท่านั้น หากคุณใช้ แหล่งที่มาตำแหน่งของคุณ ไม่จำเป็นต้องเรียกทั้งสองวิธีนี้

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

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