Chế độ Lite

SDK bản đồ dành cho Android có thể phân phát hình ảnh bitmap của bản đồ, cung cấp tương tác hạn chế đối với người dùng. Đây được gọi là bản đồ chế độ thu gọn.

Mã mẫu

Kho lưu trữ Apidemos trên GitHub bao gồm các mẫu minh hoạ cách sử dụng chế độ thu gọn:

• LitedemoActivity – Java: Kiến thức cơ bản về việc sử dụng bản đồ chế độ thu gọn trong Java
• LitedemoActivity – Kotlin: Kiến thức cơ bản về việc sử dụng bản đồ chế độ thu gọn trong Kotlin
• LiteListdemoActivity – Java: Hiển thị bản đồ hiệu quả trong ListView sử dụng chế độ thu gọn trong Java
• LiteListdemoActivity – Kotlin: Hiển thị bản đồ hiệu quả trong ListView sử dụng chế độ thu gọn trong Kotlin

Tổng quan về chế độ thu gọn

Bản đồ chế độ thu gọn là hình ảnh bitmap của bản đồ tại một vị trí và thu phóng được chỉ định cấp độ. Chế độ Lite hỗ trợ tất cả các loại bản đồ (bình thường, kết hợp, vệ tinh, địa hình) và một tập hợp con chức năng do API đầy đủ cung cấp. Chế độ thu gọn rất hữu ích khi bạn muốn cung cấp một số bản đồ trong một luồng hoặc một bản đồ mà quá nhỏ để hỗ trợ tương tác có ý nghĩa.

Người dùng xem bản đồ không thể thu phóng hoặc xoay bản đồ. Biểu tượng trên bản đồ cung cấp cho người dùng để xem bản đồ trong ứng dụng di động Google Maps và yêu cầu đường đi.

Thêm bản đồ chế độ thu gọn

Chế độ Lite sử dụng các lớp và giao diện giống như Android đầy đủ của Google Maps API. Bạn có thể đặt GoogleMap thành chế độ thu gọn trong phần sau cách:

• Ở dạng thuộc tính XML cho MapView hoặc MapFragment
• Hoặc trong đối tượng GoogleMapOptions

Dưới dạng thuộc tính XML cho MapView hoặc 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"/>

Trong đối tượng GoogleMapOptions

val options = GoogleMapOptions()
    .liteMode(true)

      

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

      

Để biết chi tiết về cách thiết lập trạng thái ban đầu của bản đồ, hãy xem hướng dẫn về đối tượng ánh xạ.

Ý định khởi chạy chế độ xem bản đồ hoặc yêu cầu chỉ đường

Theo mặc định, một thanh công cụ ở phía dưới cùng bên phải của bản đồ chứa các biểu tượng cung cấp quyền truy cập vào chế độ xem bản đồ hoặc yêu cầu chỉ đường trong ứng dụng Google Maps . Bạn có thể vô hiệu hoá thanh công cụ bằng cách gọi UiSettings.setMapToolbarEnabled(false). Để biết thêm chi tiết, hãy xem tài liệu về thanh công cụ.

Ngoài ra, theo mặc định, khi người dùng nhấn vào bản đồ, API sẽ khởi động ứng dụng Google Maps . Bạn có thể ghi đè giá trị này bằng cách sử dụng GoogleMap.setOnMapClickListener() để thiết lập trình nghe của riêng bạn. Bạn cũng có thể vô hiệu hoá các sự kiện nhấp chuột trên bản đồ, bằng cách gọi setClickable() trên thành phần hiển thị chứa MapView hoặc MapFragment. Để thông tin chi tiết về hai kỹ thuật này (hãy xem tài liệu về sự kiện).

Các sự kiện trong vòng đời

Khi sử dụng API ở chế độ tương tác hoàn toàn, người dùng lớp MapView phải chuyển tiếp tất cả phương thức trong vòng đời hoạt động đến các phương thức tương ứng trong lớp MapView. Ví dụ về các phương pháp vòng đời bao gồm onCreate(), onDestroy(), onResume() và onPause().

Khi sử dụng lớp MapView ở chế độ thu gọn, các sự kiện trong vòng đời chuyển tiếp sẽ không bắt buộc, ngoại trừ các trường hợp sau:

• Bắt buộc phải gọi onCreate(), nếu không sẽ không có bản đồ nào xuất hiện.
• Nếu bạn muốn hiển thị chấm Vị trí của tôi trên bản đồ chế độ thu gọn và sử dụng nguồn vị trí mặc định, bạn sẽ cần gọi onResume() và onPause(), vì nguồn vị trí sẽ chỉ cập nhật giữa các lệnh gọi này. Nếu bạn sử dụng nguồn vị trí của riêng bạn, bạn không cần gọi hai phương pháp này.

Các tính năng API được hỗ trợ

Bảng sau đây mô tả hoạt động của bản đồ chế độ thu gọn cho từng khu vực Chức năng API. Nếu ứng dụng gọi một phương thức không được hỗ trợ ở chế độ thu gọn, thì API sẽ ghi lại một thông báo cảnh báo.