충돌 동작 제어

플랫폼 선택: Android iOS JavaScript

충돌 동작은 마커가 다른 마커와 충돌하는 (겹치는) 경우 표시되는 방식을 관리합니다.

마커의 충돌 동작 설정

충돌 동작을 설정하려면 GMSAdvancedMarker.collisionBehavior를 다음 중 하나로 설정하세요.

  • GMSCollisionBehaviorRequired (기본값): 충돌과 관계없이 항상 마커를 표시합니다. 이것이 기본 동작입니다. 다른 마커 또는 기본 지도 라벨이 표시되는지 여부에는 영향을 미치지 않습니다.

  • GMSCollisionBehaviorOptionalAndHidesLowerPriority: 마커가 다른 마커와 겹치지 않는 경우에만 마커를 표시합니다. 이 유형의 마커 두 개가 겹치면 zIndex가 더 높은 마커가 표시됩니다. zIndex가 동일하면 세로 화면 위치가 더 낮은 마커가 표시됩니다.

  • GMSCollisionBehaviorRequiredAndHidesOptional: 충돌과 관계없이 항상 마커를 표시하고 GMSCollisionBehaviorOptionalAndHidesLowerPriority를 숨깁니다. 마커가 다른 마커와 겹치지 않는 경우에만 마커를 표시합니다. GMSCollisionBehaviorRequired하지 않습니다. 이 유형의 마커 두 개가 겹치면 zIndex가 더 높은 마커가 표시됩니다. zIndex가 동일한 마커의 충돌 규칙은 정의되지 않습니다.

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