Interagire con i punti d'interesse

Quando un utente fa clic su un punto di interesse (PDI), Maps 3D SDK for Android visualizza un widget Places per quel PDI. Puoi ascoltare gli eventi di clic e sopprimere questo widget utilizzando OnMap3DClickListener. Il widget Places richiede l'aggiunta di Places SDK come dipendenza.

Nota: per impostazione predefinita, il widget dell'interfaccia utente di Places viene visualizzato quando si fa clic su un punto di interesse. Devi sostituire questo comportamento per sopprimere il widget nella tua applicazione.

Ascolta gli eventi di clic

Per ascoltare gli eventi di clic sulla mappa, chiama setMap3DClickListener sulla tua GoogleMap3D istanza.

Quando un utente fa clic sulla mappa, il onMap3DClick callback riceve un Map3DClickEvent oggetto contenente le seguenti proprietà:

• location: The LatLngAltitude che rappresenta le coordinate geografiche e l'altitudine del clic.
• placeId: l'identificatore univoco (String?) del luogo nella posizione del clic o null se non è presente.

Il onMap3DClick metodo restituisce un valore Boolean:

• Restituisce false: mostra il widget dell'interfaccia utente di Places predefinito (se placeId non è null).
• Restituisce true: sopprime il widget dell'interfaccia utente di Places predefinito.

L'esempio seguente mostra come impostare un listener di clic e sopprimere il widget dell'interfaccia utente di Places predefinito per eseguire un'azione personalizzata:

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
}