Interactúa con lugares de interés

Foto que muestra una pequeña ventana emergente con detalles del lugar en la parte inferior de la pantalla como resultado de un 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 Places SDK como una dependencia.

Detecta 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 onMap3DClick devolución de llamada recibe un Map3DClickEvent objeto que contiene las siguientes propiedades:

  • location: Es el 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 onMap3DClick método muestra un Boolean:

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

En el siguiente ejemplo, se muestra cómo configurar un objeto de escucha de clics y suprimir el widget predeterminado de la IU de Places 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
}