Çarpışma davranışı

Platform seçin: Android iOS JavaScript

Bu sayfada, bir işaretçinin çarpışma davranışını nasıl kontrol edeceğiniz gösterilmektedir.

İşaretçi için çarpışma davranışını ayarlama

Çarpışma davranışı, bir işaretçinin çarpması (çakışması) durumunda nasıl görüntüleneceğini kontrol eder başka bir işaretçi kullanın. Gelişmiş işaretçileri oluşturma şekliniz çakışma davranışının nasıl çalışacağını belirler:

  • BitmapDescriptorFactory bit eşleme işaretçileri olarak adlandırılır. Bu işaretçiler, ana harita tarafından çizilir.

  • AdvancedMarkerOptions.iconView() yöntemi kullanılarak oluşturulanlar da dahil olmak üzere diğer tüm gelişmiş işaretçiler görüntü işaretçileri olarak adlandırılır ve ana haritanın üzerindeki bir katmanda çizilir.

Çarpışma davranışını ayarlamak için AdvancedMarkerOptions.collisionBehavior değerini aşağıdakilerden birine ayarlayın:

  • CollisionBehavior.REQUIRED: (varsayılan) Çarpışmadan bağımsız olarak işaretçiyi her zaman göster.
  • CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL Çarpışmadan bağımsız olarak işaretçiyi her zaman gösterin ve işaretçiyle OPTIONAL_AND_HIDES_LOWER_PRIORITYörtüşecek işaretçileri veya etiketleri gizleyin.

  • CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY İşaretçiyi görüntüleyin yalnızca diğer işaretçilerle çakışmıyorsa.

    • İki bit eşleme işaretçisi çakışırsa daha yüksek zIndex değerine sahip olan gösteriliyor. İki tarafta da zIndex varsa dikey ekranı daha düşük olanı konum gösteriliyor. zIndex hakkında daha fazla bilgi için bkz. İşaretçi z-index.

    • İki görüntüleme işaretçisi çakışırsa zIndex değeri daha yüksek olan işaretçi gösterilir. Aynı zIndex değerine sahiplerse en son oluşturulan işaretçi, kendisinden önce oluşturulan işaretçilerle örtüşür.

    • Görünüm işaretçileri, bitmap işaretçilerinin üzerindeki bir katmanda çizildiğinden görünüm işaretçileri bitmap işaretçileriyle çakışır. Dolayısıyla, kullanın.

Aşağıdaki örnekte bir işaretçi için çakışma davranışı ayarlama gösterilmektedir:

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