与地图注点互动

照片:点击后,屏幕底部显示包含地点详情的小弹出式窗口。

当用户点击地图注点 (POI) 时,Maps 3D SDK for Android 会显示 该 POI 的地点微件 。您可以使用 OnMap3DClickListener监听点击事件并禁止显示此微件。 地点微件要求您将 Places SDK 添加为依赖项。

监听点击事件

如需监听地图上的点击事件,请对 GoogleMap3D 实例调用 setMap3DClickListener 。

当用户点击地图时, onMap3DClick 回调会收到一个 Map3DClickEvent 对象,其中包含以下属性:

  • location: LatLngAltitude ,表示点击的地理坐标和海拔高度。
  • placeId:点击位置的地点唯一标识符 (String?),如果没有,则为 null。

onMap3DClick 方法会返回一个 Boolean:

  • Return 键 false:显示默认的地点界面微件(如果 placeId 不是 null)。
  • Return 键 true:禁止显示默认的地点界面微件。

以下示例展示了如何设置点击监听器并禁止显示默认的地点界面微件以执行自定义操作:

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
}