Chế độ Lite

SDK Maps 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 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ế độ thu gọn:

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à mức thu phóng được chỉ định. 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 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 xoay 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 Google Maps dành cho thiết bị di động và yêu cầu chỉ đường.

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

Chế độ thu gọn sử dụng cùng một lớp và giao diện như API Google Maps Android đầ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

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

Kotlin

val options = GoogleMapOptions()
    .liteMode(true)

Java

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, 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 Google Maps dành cho thiết bị di động. Bạn có thể tắt thanh công cụ 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ể tắt sự kiện nhấp chuột 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ế độ 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 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ế độ thu gọn, việc chuyển tiếp các sự kiện trong vòng đời là không bắt buộc, 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 thì sẽ không có bản đồ nào xuất hiện.
  • Nếu muốn hiển thị dấu chấm Vị trí của tôi trên bản đồ ở chế độ thu gọn và sử dụng nguồn của vị trí mặc định, bạn cần gọi onResume() và onPause(), vì nguồn của 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 của vị trí của riêng mình, thì không cần gọi hai phương thức này.

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

Bảng sau đây mô tả hành vi của bản đồ ở chế độ thu gọn cho từng khía cạnh của 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ế độ thu gọn, thì API sẽ ghi lại thông báo cảnh báo.

Chức năng
Loại bản đồ
Có được hỗ trợ không? Có
Các loại bản đồ sau đây có sẵn thông qua GoogleMapOptions.mapType() và 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ó được hỗ trợ không? Có
Chức năng của chế độ thu gọn cho hình dạng khớp với API đầy đủ.
Dự đoán
Có được hỗ trợ không? Có
Chức năng của chế độ thu gọn cho Projection khớp với API đầy đủ.
Vị trí của tôi
Có được hỗ trợ không? Có
Chức năng của 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ó được hỗ trợ không? Có
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ó được hỗ trợ không? Có
Nếu bạn đặt title() của điểm đánh dấu, thì 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 theo 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ở tuỳ chỉnh
Có được hỗ trợ không? Một phần
Maps SDK cho Android hỗ trợ kiểu tuỳ chỉnh của bản đồ cơ sở. Chế độ thu gọn chỉ hỗ trợ kiểu tuỳ chỉnh dựa trên JSON, chứ không hỗ trợ kiểu dựa trên đám mây (yêu cầu mã bản đồ để kết xuất bản đồ phong cách riêng). Chế độ thu gọn cũng không hỗ trợ việc đặt bảng phối màu của bản đồ để sử dụng chế độ tối.
Điểm đánh dấu
Có đượ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 sự kiện nhấp chuột. Bạn cũng có thể thêm biểu tượng điểm đánh dấu tuỳ chỉnh. Không thể đặt điểm đánh dấu thành có thể kéo. Điểm đánh dấu trên bản đồ ở chế độ thu gọn là điểm đánh dấu phẳng và không thể xoay.
Vị trí camera, thu phóng và ảnh động
Có được hỗ trợ không? Một phần

Bạn có thể đặt mục tiêu và mức thu phóng của camera, nhưng không thể đặt độ nghiêng hoặc hướng. 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ẽ nhận được một hình ảnh bản đồ khác ở chế độ thu gọn. Để biết thêm thông tin về cách đặ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 ảnh động cho chuyển động của camera. Chế độ xem camera sẽ di chuyển ngay lập tức đến vị trí mới.
Ánh xạ các sự kiện
Có được hỗ trợ không? Một phần

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

Để tắt sự kiện nhấp chuột trên bản đồ ở chế độ thu gọn, bạn có thể gọi setClickable() trên khung hiển thị chứa MapView hoặc MapFragment. Ví dụ: điều này rất hữu ích khi hiển thị một hoặc nhiều bản đồ trong chế độ xem danh sách, nơi 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 đồ trong nhà và toà nhà
Có được hỗ trợ không? Không
Chế độ thu gọn sẽ hiển thị các ô giống như Maps Static API. Đ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, hệ thống sẽ không làm vậy. Hơn nữa, bạn không thể thay đổi cấp độ được hiển thị hoặc thao tác với bộ chọn cấp độ.
Lớp giao thông
Có được hỗ trợ không? Không
GoogleMap.setTrafficEnabled() không được hỗ trợ ở chế độ thu gọn.
Lớp phủ mặt đất
Có được hỗ trợ không? Không
GoogleMap.addGroundOverlay() không được hỗ trợ ở chế độ thu gọn.
Lớp phủ xếp kề
Có được hỗ trợ không? Không
GoogleMap.addTileOverlay() không được hỗ trợ ở chế độ thu gọn.
Cử chỉ
Có đượ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ử chỉ sẽ không có hiệu lực.
Chế độ xem đường phố
Có được hỗ trợ không? Không
Chế độ xem đường phố không được hỗ trợ ở chế độ thu gọn.