Tương tác với các địa điểm yêu thích

Ảnh chụp một cửa sổ bật lên nhỏ có thông tin chi tiết về địa điểm ở cuối màn hình, xuất hiện sau khi người dùng nhấp vào.

Khi người dùng nhấp vào một địa điểm yêu thích (POI), SDK Maps 3D dành cho Android sẽ hiển thị một tiện ích Địa điểm cho địa điểm yêu thích đó. Bạn có thể theo dõi các sự kiện nhấp chuột và chặn tiện ích này bằng cách sử dụng OnMap3DClickListener. Tiện ích Địa điểm yêu cầu bạn thêm Places SDK làm phần phụ thuộc.

Theo dõi sự kiện nhấp chuột

Để theo dõi các sự kiện nhấp chuột trên bản đồ, hãy gọi setMap3DClickListener trên thực thể GoogleMap3D.

Khi người dùng nhấp vào bản đồ, lệnh gọi lại onMap3DClick sẽ nhận được một đối tượng Map3DClickEvent chứa các thuộc tính sau:

  • location: LatLngAltitude đại diện cho toạ độ địa lý và độ cao của lượt nhấp.
  • placeId: Giá trị nhận dạng riêng biệt (String?) cho địa điểm tại vị trí nhấp hoặc null nếu không có.

Phương thức onMap3DClick trả về một Boolean:

  • Return false: Cho thấy tiện ích giao diện người dùng Địa điểm mặc định (nếu placeId không phải là null).
  • Return true: Ngăn chặn tiện ích giao diện người dùng Địa điểm mặc định.

Ví dụ sau đây cho thấy cách đặt trình theo dõi lượt nhấp và chặn tiện ích giao diện người dùng Địa điểm mặc định để thực hiện một thao tác tuỳ chỉnh:

googleMap3D.setMap3DClickListener { clickEvent ->
    val location = clickEvent.location
    val placeId = clickEvent.placeId

    // Perform custom action, for example logging or showing a custom tooltip
    showCustomTooltip(location, placeId)

    // Suppress the default Places UI widget by returning true
    true
}