충돌 동작 제어

이 페이지에서는 마커의 충돌 동작을 설정하는 방법을 설명합니다. 충돌 동작은 마커가 다른 마커와 충돌하는(겹치는) 경우 표시되는 방식을 관리합니다.

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

  • REQUIRED: 충돌과 관계없이 항상 마커를 표시합니다.
  • REQUIRED_AND_HIDES_OPTIONAL: 충돌과 관계없이 항상 마커를 표시하고 마커와 겹치는 OPTIONAL_AND_HIDES_LOWER_PRIORITY 마커 또는 라벨을 숨깁니다.
  • OPTIONAL_AND_HIDES_LOWER_PRIORITY: 마커가 다른 마커와 겹치지 않는 경우에만 마커를 표시합니다. 이 유형의 마커 두 개가 겹치면 zIndex가 더 높은 마커가 표시됩니다. zIndex가 동일하면 세로 화면 위치가 더 낮은 광고가 표시됩니다.

다음 예는 마커의 충돌 동작을 설정하는 방법을 보여줍니다.

const marker = new Marker3DElement({
    position: {lat, lng},
    collisionBehavior: google.maps.CollisionBehavior.REQUIRED
});