Interakcja z ciekawymi miejscami

Zdjęcie przedstawiające małe wyskakujące okienko z informacjami o miejscu u dołu ekranu, które pojawia się po kliknięciu.

Gdy użytkownik kliknie ciekawe miejsce, pakiet Maps 3D SDK na Androida wyświetli widżet Miejsc dla tego miejsca. Możesz nasłuchiwać zdarzenia kliknięcia i wyłączyć ten widżet za pomocą OnMap3DClickListener. Widżet Miejsc wymaga dodania pakietu Places SDK jako zależności.

Nasłuchiwanie zdarzeń kliknięcia

Aby nasłuchiwać zdarzenia kliknięcia na mapie, wywołaj setMap3DClickListener w instancji GoogleMap3D.

Gdy użytkownik kliknie mapę, wywołanie zwrotne onMap3DClick otrzyma obiekt Map3DClickEvent zawierający te właściwości:

  • location: The LatLngAltitude reprezentujący współrzędne geograficzne i wysokość kliknięcia.
  • placeId: unikalny identyfikator (String?) miejsca w lokalizacji kliknięcia lub null, jeśli nie ma takiego miejsca.

Metoda onMap3DClick zwraca wartość Boolean:

  • Zwróć false: wyświetla domyślny widżet interfejsu Miejsc (jeśli placeId nie jest null).
  • Zwróć true: wyłącza domyślny widżet interfejsu Miejsc.

Poniższy przykład pokazuje, jak ustawić detektor kliknięć i wyłączyć domyślny widżet interfejsu Miejsc, aby wykonać niestandardową czynność:

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
}