Berinteraksi dengan lokasi menarik

Foto yang menampilkan popover kecil dengan detail tempat di bagian bawah layar yang dihasilkan dari klik.

Saat pengguna mengklik lokasi menarik (POI), Maps 3D SDK for Android akan menampilkan widget Tempat untuk POI tersebut. Anda dapat memproses peristiwa klik dan menyembunyikan widget ini menggunakan OnMap3DClickListener. Widget Places mengharuskan Anda menambahkan Places SDK sebagai dependensi.

Memproses peristiwa klik

Untuk memproses peristiwa klik pada peta, panggil setMap3DClickListener pada instance GoogleMap3D Anda.

Saat pengguna mengklik peta, callback onMap3DClick akan menerima objek Map3DClickEvent yang berisi properti berikut:

  • location: LatLngAltitude yang mewakili koordinat geografis dan ketinggian klik.
  • placeId: ID unik (String?) untuk tempat di lokasi klik, atau null jika tidak ada.

Metode onMap3DClick menampilkan Boolean:

  • Return false: Menampilkan widget UI Places default (jika placeId bukan null).
  • Return true: Menghilangkan widget UI Places default.

Contoh berikut menunjukkan cara menetapkan pemroses klik dan menyembunyikan widget UI Places default untuk melakukan tindakan kustom:

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
}