Comportamento di collisione

Seleziona la piattaforma: Android iOS JavaScript

Questa pagina mostra come controllare il comportamento di collisione di un indicatore.

Imposta il comportamento della collisione per un indicatore

Il comportamento della collisione controlla la modalità di visualizzazione di un indicatore in caso di collisione (sovrapposizione) con un altro indicatore. Il modo in cui crei gli indicatori avanzati determina il funzionamento del comportamento di collisione:

  • Gli indicatori avanzati creati utilizzando BitmapDescriptorFactory sono chiamati indicatori bitmap. Questi indicatori vengono disegnati dalla mappa di base.

  • Tutti gli altri indicatori avanzati, inclusi quelli creati utilizzando il metodo AdvancedMarkerOptions.iconView(), sono chiamati indicatori di visualizzazione e vengono disegnati su un livello sopra la mappa principale.

Per impostare il comportamento in caso di collisione, imposta AdvancedMarkerOptions.collisionBehavior su una delle seguenti opzioni:

  • CollisionBehavior.REQUIRED: (valore predefinito) mostra sempre l'indicatore indipendentemente dalla collisione.
  • CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL Visualizza sempre l'indicatore indipendentemente dalla collisione e nascondi tutti gli indicatori OPTIONAL_AND_HIDES_LOWER_PRIORITY o le etichette che si sovrappongono all'indicatore.

  • CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY Mostra l'indicatore solo se non si sovrappone ad altri indicatori.

    • Se due indicatori bitmap si sovrappongono, viene mostrato quello con il zIndex più alto. Se hanno lo stesso zIndex, viene mostrato quello con la posizione dello schermo verticale più bassa. Per ulteriori informazioni su zIndex, consulta Indici z degli indicatori.

    • Se due indicatori di visualizzazione si sovrappongono, viene mostrato quello con il zIndex più alto. Se hanno lo stesso zIndex, l'ultimo indicatore creato sovrappone tutti gli indicatori creati prima.

    • Poiché gli indicatori di visualizzazione vengono disegnati su un livello sopra gli indicatori di bitmap, gli indicatori di visualizzazione sovrappongono quelli di bitmap. Pertanto, ti consigliamo di utilizzare indicatori dello stesso tipo per un migliore controllo delle collisioni.

L'esempio seguente mostra l'impostazione del comportamento della collisione per un indicatore:

Kotlin



// Collision behavior can only be changed in the AdvancedMarkerOptions object.
// Changes to collision behavior after a marker has been created are not possible
val collisionBehavior: Int = CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL
val advancedMarkerOptions: AdvancedMarkerOptions = AdvancedMarkerOptions()
    .position(LatLng(10.0, 10.0))
    .collisionBehavior(collisionBehavior)

val marker: Marker = map.addMarker(advancedMarkerOptions) ?: error("Failed to add marker")

Java


// Collision behavior can only be changed in the AdvancedMarkerOptions object.
// Changes to collision behavior after a marker has been created are not possible
int collisionBehavior = AdvancedMarkerOptions.CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL;
AdvancedMarkerOptions options = new AdvancedMarkerOptions()
        .position(new LatLng(10.0, 10.0))
        .collisionBehavior(collisionBehavior);

Marker marker = map.addMarker(options);