마커

지도 상에 하나의 지점을 표시할 때 사용되며 아이콘, 타이틀 등으로 정보를 표현할 수 있습니다. 원하는 아이콘 이미지를 표출하거나 회전, 투명도 등 다양한 속성을 제공합니다. 마커를 지도 위에 그리는 방법을 설명합니다.

Last updated 4 years ago

Was this helpful?

추가 및 삭제

지도 위 특정 지점에 마커를 추가하려면 객체를 생성한 다음 반드시 속성을 설정해주어야 합니다. 속성은 함수를 사용하거나, 마커 객체 생성자를 통해 설정할 수 있습니다.

생성된 마커 객체의 속성을 표출하고자 하는 지도 객체로 설정하면 지도 위에 마커가 표출됩니다.

// 지도 위에 마커 추가
val marker = InvMarker().apply {
    position = LatLng(37.40219, 127.11047)
    map = inaviMap
}

// 지도에서 마커 제거
marker.map = null

아이콘은 지도 상에 표출될 마커 형태를 의미합니다. 이미지, 앵커, 회전 등의 속성을 지원합니다.

// 드로어블 리소스를 이용하여 마커 아이콘 이미지 설정
marker.iconImage = InvImage(R.drawable.marker_icon)

// 기본으로 제공되는 이미지를 이용하여 마커 아이콘 이미지 설정
marker.iconImage = InvMarkerIcons.BLUE

// 마커의 아이콘 이미지를 45도 회전
marker.angle = 45f

// 마커의 아이콘 이미지 크기를 2배로 설정
marker.iconScale = 2.0f

마커가 표출되는 지점에 간단한 정보를 텍스트 형태로 표현할 때 사용합니다.

marker.title = "타이틀" // 타이틀 "타이틀"로 설정

marker.title = "동해물과 백두산이 마르고 닳도록 하느님이 보우하사 우리나라 만세"
marker.titleMaxWidth = 100 // 타이틀 최대 가로 길이를 100px로 설정

marker.titleColor = Color.YELLOW // 타이틀 색상 : 노란색
marker.titleHaloColor = Color.BLACK // 타이틀 외곽선 색상 : 검은색

// 타이틀 크기를 20dp로 설정
marker.titleSize = 20f

// 마커의 불투명도를 0.5로 설정
marker.alpha = 0.5f

필요에 따라 여러 개의 마커를 가깝게 배치해야 하는 경우가 있습니다. 이 때, 각각의 마커는 겹침이 발생하게 되며, 아이콘과 텍스트가 서로 겹쳐 표출되어 시인성이 저하되는 상황이 발생할 수 있습니다.

다음 속성으로 우선순위에 따라 마커를 표출하는 방식을 설정할 수 있습니다.

Last updated 4 years ago

Was this helpful?