Cómo controlar el comportamiento de colisión

Selecciona la plataforma: Android iOS JavaScript

El comportamiento de colisión controla cómo se muestra un marcador si se superpone con otro.

Cómo configurar el comportamiento de colisión de un marcador

Para configurar el comportamiento de colisión, establece GMSAdvancedMarker.collisionBehavior en una de las siguientes opciones:

• GMSCollisionBehaviorRequired (opción predeterminada): Indica que el marcador debe mostrarse siempre, independientemente de las superposiciones. Este es el comportamiento predeterminado. No influye en si se muestran otros marcadores o etiquetas de mapa base.

• GMSCollisionBehaviorOptionalAndHidesLowerPriority: Muestra el marcador solo si no se superpone con otros. Si dos marcadores de este tipo se superponen, se mostrará el que tenga el valor de zIndex más alto. Si tienen el mismo valor de zIndex, se mostrará el que tenga la posición vertical más baja en la pantalla.

• GMSCollisionBehaviorRequiredAndHidesOptional: Indica que el marcador debe mostrarse siempre, independientemente de las superposiciones, y que se oculta cualquier GMSCollisionBehaviorOptionalAndHidesLowerPriority. Muestra el marcador solo si no se superpone con otros. No GMSCollisionBehaviorRequired. Si dos marcadores de este tipo se superponen, se mostrará el que tenga el valor de zIndex más alto. Las reglas de colisión para marcadores con el mismo zIndex no están definidas.

  Nota: Para lograr un comportamiento de colisión óptimo, crea todos los marcadores avanzados con el mismo tipo. Esto incluye marcadores avanzados que se representan con un ícono iconView o con funciones predeterminadas.

Swift

// Defines a marker to always display and hide any marker or label overlay with this marker in the base map
marker.collisionBehavior = .requiredAndHidesOptional

Objective‑C

// Defines a marker to always display and hide any marker or label overlay with this marker in the base map
marker.collisionBehavior = GMSCollisionBehaviorRequiredAndHidesOptional