마커

마커를 사용하여 지도의 특정 위치에 사용자의 관심을 유도합니다. 이 가이드에서는 3D 지도에서 마커를 사용하고 맞춤설정하는 방법을 보여줍니다. 마커가 표시되는 고도 외에도 마커의 모양, 크기, 색상을 제어할 수 있습니다.

마커를 사용하여 지도에 위치를 표시합니다. 위의 예는 맞춤설정이 적용되지 않은 간단한 단일 마커를 보여줍니다.

색상, 크기, 아이콘 이미지 맞춤설정

기본 마커의 배경, 글리프, 테두리 색상, 크기를 맞춤설정합니다.

맞춤 마커

샘플 사용해 보기

기본 마커 아이콘을 맞춤 SVG 리소스로 대체합니다.

그래픽이 있는 마커

샘플 사용해 보기

마커 고도 설정

마커를 돌출하고 고도를 설정하여 마커 고도를 설정할 수 있습니다.

돌출된 마커

샘플 사용해 보기

충돌 동작 제어

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

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

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