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 khả năng tương tác có giới hạn 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ế độ thu gọn:

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

Bản đồ chế độ thu gọn là hình ảnh bitmap của một bản đồ ở một vị trí cụ thể và mức thu phóng. Chế độ thu gọn 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 sẽ hữu ích khi bạn muốn cung cấp một số bản đồ trong một luồng hoặc bản đồ 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 đồ. Các biểu tượng trên bản đồ cho phép người dùng truy cập vào bản đồ trong ứng dụng dành cho thiết bị 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ư API đầy đủ của Android Maps. Bạn có thể đặt GoogleMap thành chế độ thu gọn theo những cách sau:

  • Dưới 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

Java


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

      

Kotlin


val options = 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 dành cho đố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, thanh công cụ ở dưới cùng bên phải của bản đồ chứa các biểu tượng cho phép 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ụ 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 dành cho thiết bị di động. 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 mình. Bạn cũng có thể tắt các sự kiện nhấp chuột trên bản đồ bằng cách gọi setClickable() trên chế độ xem có 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 chu kỳ hoạt động

Khi sử dụng API ở chế độ tương tác hoàn toàn, người dùng của lớp MapView phải chuyển tiếp tất 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()onPause().

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

  • Bạn 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 hiển thị 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 cần gọi onResume()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 phải gọi hai phương thức này.

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 mỗi khu vực chức năng của API. Nếu ứng dụng gọi một phương thức không được hỗ trợ ở chế độ thu gọn, API sẽ ghi lại thông báo cảnh báo.

Chức năng
Loại bản đồ
Có hỗ trợ không?
Bạn có thể sử dụng các loại bản đồ sau qua GoogleMapOptions.mapType()GoogleMap.setMapType(): MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN, MAP_TYPE_HYBRID, MAP_TYPE_NONE
Hình nhiều đường, đa giác, hình tròn
Có hỗ trợ không?
Chức năng chế độ thu gọn cho các hình dạng khớp với API đầy đủ.
Dự đoán
Có hỗ trợ không?
Chức năng chế độ thu gọn cho Chiếu chiếu khớp với API đầy đủ.
Vị trí của tôi
Có hỗ trợ không?
Chức năng chế độ thu gọn cho lớp Vị trí của tôi khớp với API đầy đủ.
Khoảng đệm bản đồ
Có hỗ trợ không?
Tính năng hỗ trợ chế độ thu gọn cho khoảng đệm bản đồ khớp với API đầy đủ.
Cửa sổ thông tin
Có hỗ trợ không?
Nếu bạn đặt title() của một điểm đánh dấu, cửa sổ thông tin mặc định sẽ xuất hiện khi người dùng nhấn vào điểm đánh dấu đó. Bạn có thể hiển thị cửa sổ thông tin bằng cách lập trình bằng cách gọi showInfoWindow() trên điểm đánh dấu. Bạn cũng có thể tạo cửa sổ thông tin tuỳ chỉnh thông qua giao diện InfoWindowAdapter.
Kiểu bản đồ cơ sở tùy chỉnh
Có hỗ trợ không? Một phần
SDK Maps dành cho Android hỗ trợ kiểu tùy chỉnh của bản đồ cơ sở. Chế độ Lite chỉ hỗ trợ tạo kiểu tùy chỉnh dựa trên JSON, không hỗ trợ tạo kiểu trên đám mây yêu cầu mã bản đồ để hiển thị bản đồ được tạo kiểu.
Đánh dấu
Có hỗ trợ không? Một phần
Bạn có thể thêm một điểm đánh dấu và phản hồi một sự kiện nhấp. Bạn cũng có thể thêm biểu tượng điểm đánh dấu tùy chỉnh. Không thể tạo điểm đánh dấu có thể kéo. Điểm đánh dấu trên bản đồ chế độ thu gọn phẳng và không thể xoay.
Vị trí máy ảnh, thu phóng và ảnh động
Có hỗ trợ không? Một phần

Bạn có thể đặt mục tiêu và thu phóng máy ảnh, nhưng không thể đặt độ nghiêng hoặc góc phương vị. Mức thu phóng được làm tròn đến số nguyên gần nhất ở chế độ thu gọn. Khi gọi GoogleMap.moveCamera(), bạn sẽ thấy một hình ảnh bản đồ khác ở chế độ thu gọn. Để biết thêm thông tin về cách cài đặt và thao tác với máy ảnh, hãy xem phần Thay đổi chế độ xem.

Việc gọi GoogleMap.animateCamera() sẽ không tạo được ảnh động của chuyển động máy ảnh. Chế độ xem máy ảnh sẽ di chuyển tức thì sang vị trí mới.

Ánh xạ các sự kiện
Có hỗ trợ không? Một phần

Chế độ thu gọn hỗ trợ GoogleMap.setOnMapClickListener()GoogleMap.setOnMapLongClickListener().

Để tắt các sự kiện nhấp trên bản đồ ở chế độ thu gọn, bạn có thể gọi setClickable() trên chế độ xem có chứa MapView hoặc MapFragment. Ví dụ: chức năng này rất hữu ích, chẳng hạn như khi hiển thị một bản đồ hoặc bản đồ ở chế độ xem danh sách, trong đó bạn muốn sự kiện nhấp chuột gọi một hành động không liên quan đến bản đồ.

Để biết thông tin chi tiết, hãy xem tài liệu về sự kiện.

Bản đồ và toà nhà trong nhà
Có hỗ trợ không? Không
Chế độ thu gọn sẽ hiển thị các ô giống với API tĩnh của Maps. Điều này có nghĩa là nếu sơ đồ tầng trong nhà được đưa vào ô mặc định, thì sơ đồ đó sẽ xuất hiện. Nếu không, nó sẽ không hiển thị. Ngoài ra, bạn không thể thay đổi cấp độ hiển thị hoặc thao tác với một bộ chọn cấp độ.
Lớp giao thông
Có hỗ trợ không? Không
GoogleMap.setTrafficEnabled() không được hỗ trợ trong chế độ thu gọn.
Lớp phủ mặt đất
Có hỗ trợ không? Không
GoogleMap.addGroundOverlay() không được hỗ trợ ở chế độ lite.
Lớp phủ xếp kề
Có hỗ trợ không? Không
GoogleMap.addTileOverlay() không được hỗ trợ ở chế độ lite.
Cử chỉ
Có hỗ trợ không? Không
Chế độ thu gọn không hỗ trợ cử chỉ. Việc bật và tắt các cử chỉ sẽ không có hiệu lực.
Chế độ xem phố
Có hỗ trợ không? Không
Chế độ xem phố không được hỗ trợ trong chế độ thu gọn.