Interactúa con lugares de interés

Foto que muestra un pequeño cuadro emergente con los detalles del lugar en la parte inferior de la pantalla, que aparece después de hacer clic.

Cuando un usuario hace clic en un lugar de interés (POI), el SDK de Maps 3D para Android muestra un widget de Places para ese POI. Puedes escuchar los eventos de clic y suprimir este widget con OnMap3DClickListener. El widget de Places requiere que agregues el SDK de Places como dependencia.

Cómo escuchar eventos de clic

Para escuchar eventos de clic en el mapa, llama a setMap3DClickListener en tu instancia de GoogleMap3D.

Cuando un usuario hace clic en el mapa, la devolución de llamada onMap3DClick recibe un objeto Map3DClickEvent que contiene las siguientes propiedades:

  • location: Es el objeto LatLngAltitude que representa las coordenadas geográficas y la altitud del clic.
  • placeId: Es el identificador único (String?) del lugar en la ubicación del clic o null si no hay ninguno.

El método onMap3DClick devuelve un Boolean:

  • Retorno false: Muestra el widget de IU de Places predeterminado (si placeId no es null).
  • Return true: Suprime el widget de la IU de Places predeterminado.

En el siguiente ejemplo, se muestra cómo configurar un objeto de escucha de clics y suprimir el widget de IU de Places predeterminado para realizar una acción personalizada:

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
}