Zachowanie w przypadku kolizji

Wybierz platformę: Android iOS JavaScript

Na tej stronie dowiesz się, jak kontrolować zachowanie znacznika przy kolizji.

Ustawianie zachowania znaczników przy kolizji

Zachowanie znaczników przy kolizji określa, jak znacznik będzie wyświetlany, jeśli będzie się nakładać na inny znacznik. Sposób tworzenia zaawansowanych znaczników określa, jak działa zachowanie przy kolizji:

• Zaawansowane markery utworzone za pomocąBitmapDescriptorFactory są nazywane markerami mapy bitowej. Te znaczniki są rysowane przez podstawową mapę.

• Wszystkie inne zaawansowane znaczniki, w tym te utworzone za pomocą metody AdvancedMarkerOptions.iconView(), są nazywane znacznikami widoku i są rysowane na warstwie nad mapą podstawową.

Uwaga: aby uzyskać optymalne zachowanie w przypadku kolizji, utwórz wszystkie zaawansowane markery tego samego typu. Oznacza to, że jeśli używasz znacznika widoku w przypadku jednego znacznika, musisz używać go w przypadku wszystkich pozostałych.

Aby ustawić zachowanie przy kolizji, ustaw w atrybucie AdvancedMarkerOptions.collisionBehavior jedną z tych wartości:

• CollisionBehavior.REQUIRED: (domyślnie) Zawsze wyświetlaj znacznik niezależnie od kolizji.
• CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL Zawsze wyświetlaj znacznik niezależnie od kolizji i ukrywaj wszystkie znaczniki OPTIONAL_AND_HIDES_LOWER_PRIORITY lub etykiety, które mogłyby się z nim pokrywać.

• CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY Wyświetlaj znacznik tylko wtedy, gdy nie nakłada się na inne znaczniki.

  • Jeśli 2 znaczniki bitmapy nakładają się na siebie, wyświetlany jest ten z wyższą wartością zIndex. Jeśli mają ten sam atrybut zIndex, wyświetlany jest ten znacznik, który znajduje się niżej na ekranie. Więcej informacji o parametrze zIndex znajdziesz w sekcji Indeks Z znacznika.

  • Jeśli 2 znaczniki wyświetlenia nakładają się na siebie, wyświetlany jest ten z wyższą wartością zIndex. Jeśli mają ten sam zIndex, ostatni utworzony znacznik nakłada się na wszystkie znaczniki utworzone wcześniej.

  • Markery widoku są rysowane na warstwie powyżej markerów mapy bitowej, więc markery widoku nakładają się na markery mapy bitowej. Dlatego, aby lepiej kontrolować kolizje, używaj markerów tego samego typu.

W przykładzie poniżej pokazujemy, jak ustawić zachowanie znacznika przy kolizji:

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);