충돌 동작 제어

플랫폼 선택: Android iOS JavaScript

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

마커의 충돌 동작 설정

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

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

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

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

  참고: 최적의 충돌 동작 성능을 얻으려면 모든 고급 마커를 같은 유형으로 만드세요. 여기에는 iconView, 아이콘 또는 기본 기능으로 표시되는 고급 마커가 포함됩니다.

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