Khi sử dụng SDK Maps dành cho Android, bạn có thể tuỳ chỉnh cách người dùng có thể tương tác với bản đồ, bằng cách xác định thành phần giao diện người dùng tích hợp nào sẽ xuất hiện trên bản đồ và cử chỉ nào được cho phép.
Mã mẫu
Kho lưu trữ Apidemos trên GitHub bao gồm một mẫu minh hoạ việc sử dụng các tuỳ chọn điều khiển và cử chỉ:
- UiSettingsDemoActivity: Mẫu Kotlin
- UiSettingsDemoActivity: Mẫu Java
Chế độ thu gọn giúp người dùng ít phải tương tác nhất
Nếu bạn muốn có một bản đồ nhẹ với sự tương tác của người dùng ở mức tối thiểu, hãy cân nhắc sử dụng bản đồ ở chế độ thu gọn. Chế độ Lite cung cấp hình ảnh bitmap của bản đồ ở một vị trí và mức thu phóng được chỉ định. Ở chế độ thu gọn, người dùng không thể xoay hoặc thu phóng bản đồ và các cử chỉ sẽ không hoạt động. Để biết thông tin chi tiết, hãy xem hướng dẫn về chế độ thu gọn.
Thành phần điều khiển trên giao diện người dùng
API Maps cung cấp các chế độ điều khiển giao diện người dùng tích hợp sẵn tương tự như các chế độ điều khiển có trong ứng dụng Google Maps trên điện thoại Android. Bạn có thể bật/tắt chế độ hiển thị của các chế độ điều khiển này bằng cách sử dụng lớp UiSettings có thể lấy từ GoogleMap bằng phương thức GoogleMap.getUiSettings. Những thay đổi đối với lớp này sẽ được phản ánh ngay lập tức trên bản đồ. Để xem ví dụ về các tính năng này, hãy xem hoạt động minh hoạ Cài đặt giao diện người dùng trong ứng dụng mẫu.
Bạn cũng có thể định cấu hình hầu hết các tuỳ chọn này khi bản đồ được tạo thông qua các thuộc tính XML hoặc sử dụng lớp GoogleMapOptions. Xem phần Định cấu hình trạng thái ban đầu để biết thêm chi tiết.
Mỗi thành phần điều khiển giao diện người dùng có một vị trí được xác định trước tương ứng với cạnh của bản đồ.
Bạn có thể di chuyển các nút điều khiển ra khỏi cạnh trên cùng, dưới cùng, bên trái hoặc bên phải bằng cách thêm khoảng đệm vào đối tượng GoogleMap.
Điều khiển thu phóng
API Maps cung cấp các chế độ điều khiển thu phóng tích hợp sẵn xuất hiện ở góc dưới cùng bên phải của bản đồ. Các tính năng này bị tắt theo mặc định, nhưng bạn có thể bật bằng cách gọi UiSettings.setZoomControlsEnabled(true).
La bàn
API Maps cung cấp hình ảnh la bàn xuất hiện ở góc trên cùng bên trái của bản đồ trong một số trường hợp. La bàn sẽ chỉ xuất hiện khi máy ảnh có hướng sao cho có góc nghiêng khác 0 hoặc độ nghiêng khác 0. Khi người dùng nhấp vào la bàn, máy ảnh sẽ chuyển động trở lại vị trí có góc phương vị và độ nghiêng bằng 0 (hướng mặc định) và la bàn sẽ biến mất ngay sau đó. Bạn có thể tắt hoàn toàn việc la bàn xuất hiện bằng cách gọi UiSettings.setCompassEnabled(boolean).
Tuy nhiên, bạn không thể buộc la bàn luôn hiển thị.
Nút Vị trí của tôi
Nút Vị trí của tôi chỉ xuất hiện ở góc trên cùng bên phải màn hình khi lớp Vị trí của tôi được bật. Để biết thông tin chi tiết, vui lòng xem hướng dẫn về dữ liệu vị trí.
Bộ chọn cấp độ
Theo mặc định, bộ chọn cấp độ (bộ chọn sàn) sẽ xuất hiện gần cạnh bên phải ở giữa màn hình khi người dùng đang xem bản đồ trong nhà. Khi có hai hoặc nhiều bản đồ trong nhà hiển thị, bộ chọn cấp độ sẽ áp dụng cho toà nhà đang được lấy tiêu điểm, thường là toà nhà gần giữa màn hình nhất. Mỗi toà nhà có một cấp mặc định sẽ được chọn khi bộ chọn xuất hiện lần đầu tiên. Người dùng có thể chọn một cấp độ khác bằng cách chọn cấp độ đó trong bộ chọn.
Bạn có thể bật hoặc tắt chế độ kiểm soát bộ chọn cấp bằng cách gọi GoogleMap.getUiSettings().setIndoorLevelPickerEnabled(boolean).
Điều này rất hữu ích nếu bạn muốn thay thế bộ chọn cấp mặc định bằng bộ chọn cấp của riêng mình.
Thanh công cụ bản đồ
Theo mặc định, một thanh công cụ sẽ xuất hiện ở dưới cùng bên phải của bản đồ khi người dùng nhấn vào một điểm đánh dấu. Thanh công cụ cho phép người dùng truy cập nhanh vào ứng dụng Google Maps dành cho thiết bị di động.
Bạn có thể bật và tắt thanh công cụ bằng cách gọi UiSettings.setMapToolbarEnabled(boolean).
Trong bản đồ chế độ thu gọn, thanh công cụ vẫn tồn tại độc lập với thao tác của người dùng. Trong một bản đồ tương tác đầy đủ, thanh công cụ sẽ trượt vào khi người dùng nhấn vào một điểm đánh dấu và trượt ra một lần nữa khi điểm đánh dấu không còn nằm trong tiêu điểm.
Thanh công cụ hiển thị 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. Khi người dùng nhấn vào một biểu tượng trên thanh công cụ, API sẽ tạo một ý định để chạy hoạt động tương ứng trong ứng dụng Google Maps dành cho thiết bị di động.
Thanh công cụ hiển thị ở phía dưới cùng bên phải của bản đồ trong ảnh chụp màn hình bên trên. Khi không, một hoặc cả hai biểu tượng ý định sẽ xuất hiện trên bản đồ, tuỳ thuộc vào nội dung của bản đồ và miễn là ứng dụng Google Maps dành cho thiết bị di động hỗ trợ ý định phát sinh.
Cử chỉ ánh xạ
Bản đồ được tạo bằng SDK Maps dành cho Android hỗ trợ các cử chỉ tương tự như ứng dụng Google Maps. Tuy nhiên, có thể có những trường hợp bạn muốn tắt một số cử chỉ để duy trì trạng thái của bản đồ. Bạn cũng có thể đặt các chế độ thu phóng, kéo, nghiêng và góc phương vị theo phương thức lập trình – xem phần Máy ảnh và Chế độ xem để biết thêm thông tin chi tiết. Xin lưu ý rằng việc tắt các cử chỉ không ảnh hưởng đến việc bạn có thể thay đổi vị trí máy ảnh theo phương thức lập trình hay không.
Giống như các thành phần điều khiển trên giao diện người dùng, bạn có thể bật/tắt các cử chỉ bằng lớp UiSettings có thể lấy được từ GoogleMap bằng cách gọi GoogleMap.getUiSettings. Các thay đổi thực hiện trên lớp này sẽ được phản ánh ngay lập tức trên bản đồ. Để xem ví dụ về các tính năng này, hãy xem hoạt động minh hoạ Cài đặt giao diện người dùng trong ứng dụng mẫu (xem tại đây để biết cách cài đặt).
Bạn cũng có thể định cấu hình các tuỳ chọn này khi bản đồ được tạo thông qua Thuộc tính XML hoặc sử dụng lớp GoogleMapOptions.
Xem phần Định cấu hình bản đồ để biết thêm chi tiết.
Cử chỉ thu phóng
Bản đồ này phản hồi nhiều cử chỉ có thể thay đổi mức thu phóng của máy ảnh:
- Nhấn đúp để tăng mức thu phóng thêm 1 (Phóng to).
- Nhấn bằng hai ngón tay để giảm mức thu phóng xuống 1 (thu nhỏ).
- chụm/kéo giãn hai ngón tay
- Thu phóng bằng cách nhấn đúp nhưng không thả ngón tay ra ở lần nhấn thứ hai, sau đó trượt ngón tay lên để thu nhỏ hoặc xuống để phóng to.
Bạn có thể tắt cử chỉ thu phóng bằng cách gọi UiSettings.setZoomGesturesEnabled(boolean). Điều này sẽ không ảnh hưởng đến việc người dùng có thể sử dụng các nút điều khiển thu phóng để phóng to và thu nhỏ hay không.
Cử chỉ cuộn (kéo)
Người dùng có thể cuộn (xoay) xung quanh bản đồ bằng cách dùng ngón tay kéo bản đồ.
Bạn có thể tắt tính năng cuộn bằng cách gọi UiSettings.setScrollGesturesEnabled(boolean).
Cử chỉ nghiêng
Người dùng có thể nghiêng bản đồ bằng cách đặt hai ngón tay trên bản đồ và di chuyển 2 ngón tay xuống hoặc lên cùng nhau để tăng hoặc giảm góc nghiêng tương ứng. Bạn có thể tắt cử chỉ nghiêng bằng cách gọi UiSettings.setTiltGesturesEnabled(boolean).
Xoay cử chỉ
Người dùng có thể xoay bản đồ bằng cách đặt hai ngón tay trên bản đồ và áp dụng một chuyển động xoay. Bạn có thể tắt tính năng xoay bằng cách gọi UiSettings.setRotateGesturesEnabled(boolean).