마커, 라벨, 관심 장소(POI)의 충돌 관리

이 페이지에서는 POI나 거리 이름 등 지도에 추가하는 마커와 기본 라벨 간의 충돌을 관리하는 방법을 확인할 수 있습니다.

시작하기 전에

마커와 라벨의 충돌을 관리하려면 지도 ID를 사용해야 합니다.

라이트 모드를 통해 비트맵 이미지의 지도를 사용하는 경우 마커와 라벨의 충돌을 관리할 수 없습니다.

마커 우선순위 지정하기

Marker.CollisionBehavior 속성을 사용하여 마커에 우선순위를 지정합니다.

다음 값 중 하나를 사용하세요.

  • REQUIRED - 기본값입니다. 다른 마커, 라벨, POI와 중복되는 마커를 표시해야 합니다.
  • OPTIONAL_AND_HIDES_LOWER_PRIORITY - 마커가 대체되거나, 필수 마커와 중복되거나, 우선순위가 더 높은 OPTIONAL_AND_HIDES_LOWER_PRIORITY 마커로 대체될 수 있음을 나타냅니다. zIndex를 사용하면 OPTIONAL_AND_HIDES_LOWER_PRIORITY 마커 사이의 상대적인 우선순위를 결정하는 데 도움이 됩니다. zIndex 값이 클수록 우선순위가 더 높습니다.
  • REQUIRED_AND_HIDES_OPTIONAL - 마커를 표시해야 하며, 해당 마커와 중복되는 OPTIONAL_AND_HIDES_LOWER_PRIORITY 마커, 라벨, POI가 있다면 숨겨야 합니다. 마커가 다른 필수 마커와 중복될 수 있습니다.

다음 코드 예시에서는 새 마커의 CollisionBehavior 설정을 보여줍니다.

Java


Marker marker = map.addMarker(
    new MarkerOptions()
        .position(new LatLng(10, 10))
        .zIndex(10) // Optional.
        .collisionBehavior(Marker.CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY));

Kotlin


val marker = map.addMarker(
    MarkerOptions()
        .position(LatLng(10.0, 10.0))
        .zIndex(10f) // Optional.
        .collisionBehavior(Marker.CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY)
)