與搜尋點互動

相片:點選後,畫面底部會顯示小型彈出式視窗,內含地點詳細資料。

使用者點選搜尋點時,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
}