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 SDK Map 3D na Androida wyświetli widżet Miejsc dla tego miejsca. Możesz nasłuchiwać zdarzeń kliknięcia i ukryć ten widżet za pomocą OnMap3DClickListener. Widżet Miejsca wymaga dodania pakietu Places SDK jako zależności.

Nasłuchiwanie zdarzeń kliknięcia

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

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

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

Metoda onMap3DClick zwraca obiekt Boolean:

  • Return false: pokazuje domyślny widżet interfejsu Miejsc (jeśli placeId nie jest null).
  • Return true: pomija domyślny widżet interfejsu Miejsc.

Poniższy przykład pokazuje, jak ustawić detektor kliknięć i pominąć domyślny widżet interfejsu Miejsc, aby wykonać działanie niestandardowe:

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
}