Interagir avec les points d'intérêt

Photo montrant une petite fenêtre pop-over avec les détails d'un lieu en bas de l'écran, qui s'affiche après un clic.

Lorsqu'un utilisateur clique sur un point d'intérêt (POI), le SDK Maps 3D pour Android affiche un widget Places pour ce POI. Vous pouvez écouter les événements de clic et supprimer ce widget à l'aide de OnMap3DClickListener. Le widget Places nécessite que vous ajoutiez le SDK Places 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 instance GoogleMap3D.

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

  • location : 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 s'il n'y en a pas.

La méthode onMap3DClick renvoie un Boolean :

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

L'exemple suivant montre comment définir un écouteur de clics 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
}