Interagir avec les points d'intérêt

Photo montrant un petit pop-up avec les détails d'un lieu en bas de l'écran suite à un clic.

Lorsqu'un utilisateur clique sur un point d'intérêt, le SDK Maps 3D pour Android affiche un widget Places pour ce point d'intérêt. Vous pouvez écouter les événements de clic et supprimer ce widget à l'aide de OnMap3DClickListener. Le widget Places vous oblige à ajouter le Places SDK en tant que dépendance.

Écouter les événements de clic

Pour écouter les événements de clic sur la carte, appelez setMap3DClickListener sur votre GoogleMap3D instance.

Lorsqu'un utilisateur clique sur la carte, le onMap3DClick rappel reçoit un Map3DClickEvent objet contenant les propriétés suivantes :

  • location : The LatLngAltitude représentant les coordonnées géographiques et l'altitude du clic.
  • placeId: identifiant unique (String?) du lieu à l'emplacement du clic, ou null si aucun.

La onMap3DClick méthode renvoie une valeur Boolean :

  • Retour false : affiche le widget d'interface utilisateur Places par défaut (si placeId n'est pas null).
  • Return true : supprime le widget d'interface utilisateur Places par défaut.

L'exemple suivant montre comment définir un écouteur de clic et supprimer le widget d'interface utilisateur Places par défaut pour effectuer une action personnalisée :

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
}