使用者點選搜尋點時,Maps 3D SDK for Android 會顯示該搜尋點的Place Widgets。您可以使用 OnMap3DClickListener 監聽點擊事件並隱藏這個小工具。您必須將 Places SDK 新增為依附元件,才能使用地點小工具。
監聽點擊事件
如要監聽地圖上的點擊事件,請在 GoogleMap3D 執行個體上呼叫 setMap3DClickListener。
使用者點按地圖時,onMap3DClick 回呼會收到 Map3DClickEvent 物件,其中包含下列屬性:
location:LatLngAltitude代表點擊的地理座標和海拔高度。placeId:點擊位置的地點專屬 ID (String?),如果沒有則為null。
onMap3DClick 方法會傳回 Boolean:
- Return
false:顯示預設的 Places UI 小工具 (如果placeId不是null)。 - Return
true:禁止顯示預設的 Places UI 小工具。
以下範例說明如何設定點擊事件監聽器,並隱藏預設的 Places UI 小工具,以執行自訂動作:
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
}