충돌 동작 제어

플랫폼 선택: 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

달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.

최종 업데이트: 2026-09-10(UTC)