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 Place Widgets cho POI đó. Bạn có thể theo dõi các sự kiện nhấp chuột và ngă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 SDK Địa điểm làm phần phụ thuộc.

Theo dõi các 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: The 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ó.

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

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

Ví dụ sau đây cho thấy cách thiết lập trình theo dõi lượt nhấp và ngăn tiện ích Địa điểm trên giao diện người dùng 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
}