Chế độ Lite

SDK Maps dành cho Android có thể phân phát hình ảnh bitmap của bản đồ, mang đến khả năng tương tác hạn chế cho 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ế độ đơn giản:

• LiteDemoActivity – Java: Kiến thức cơ bản về cách sử dụng bản đồ ở chế độ thu gọn trong Java
• LiteDemoActivity – Kotlin: Kiến thức cơ bản về cách sử dụng bản đồ ở chế độ thu nhỏ trong Kotlin
• LiteListDemoActivity – Java: Hiển thị bản đồ một cách hiệu quả trong ListView bằng chế độ thu gọn trong Java
• LiteListDemoActivity – Kotlin: Hiển thị bản đồ một cách hiệu quả trong ListView bằng chế độ thu nhỏ trong Kotlin

Tổng quan về chế độ Lite

Bản đồ ở chế độ đơn giản là hình ảnh bitmap của một bản đồ tại một vị trí và mức thu phóng cụ thể. Chế độ thu nhỏ 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 số 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 đồ quá nhỏ để hỗ trợ hoạt động tương tác có ý nghĩa.

Người dùng xem bản đồ không thể thu phóng hoặc di chuyển bản đồ. Các biểu tượng trên bản đồ cho phép người dùng xem bản đồ trong ứng dụng di động Google Maps và yêu cầu chỉ đường.

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

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

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

Là một 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 thông tin chi tiết về cách đặt trạng thái ban đầu của bản đồ, hãy xem hướng dẫn về đối tượng bản đồ.

Ý đị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ụ ở 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 di động Google Maps. Bạn có thể tắt thanh công cụ này bằng cách gọi UiSettings.setMapToolbarEnabled(false). Để biết thêm thông tin, 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 di động Google Maps. Bạn có thể ghi đè hành vi này bằng cách sử dụng GoogleMap.setOnMapClickListener() để đặt 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 trên bản đồ bằng cách gọi setClickable() trên khung hiển thị chứa MapView hoặc MapFragment. Để biết thông tin chi tiết về hai kỹ thuật này, hãy xem tài liệu về sự kiện.

Sự kiện trong vòng đời

Khi sử dụng API ở chế độ hoàn toàn tương tác, người dùng lớp MapView phải chuyển tiếp tất cả các phương thức 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 thức vòng đời bao gồm onCreate(), onDestroy(), onResume() và onPause().

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

• Bạn 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 muốn cho thấy dấu 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 sử dụng nguồn vị trí của riêng mình, bạn không cần gọi hai phương thức này.

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

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