📖 네이버 지도 마커

AndroidManifest.xml

<meta-data
            android:name="com.naver.maps.map.CLIENT_ID"
            android:value="ootzd3244r" />

종속성 추가

//Naver Map
implementation("com.naver.maps:map-sdk:3.17.0")
implementation("com.google.android.gms:play-services-location:17.0.0")

코드

class RecordDetailMapFragment : Fragment(), OnMapReadyCallback {
    private lateinit var naverMap: NaverMap
    private lateinit var mapView: MapView
...

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)

    // mapView 변수 초기화
    mapView = binding.mvRecordDetailFullMap
    mapView.onCreate(savedInstanceState)
    mapView.getMapAsync(this)
}

override fun onMapReady(naverMap: NaverMap) {
    // 마커 객체 생성
    val marker = Marker()

    // 마커 위치 설정 (예: 서울 시청)
    marker.position = LatLng(37.5663, 126.9779)

    // 마커 타이틀 설정 (선택 사항)
    marker.captionText = "서울 시청"

    // 마커 아이콘 설정 (선택 사항)
    marker.icon = OverlayImage.fromResource(R.drawable.marker_icon)

    // 마커 지도에 추가
    marker.map = naverMap

    // 카메라 위치와 줌 레벨 조정 (선택 사항)
    val cameraUpdate = CameraUpdate.scrollTo(marker.position).animate(CameraAnimation.Easing)
    naverMap.moveCamera(cameraUpdate)
    naverMap.moveCamera(CameraUpdate.zoomTo(10.0))
}

맵뷰가 안드로이드의 생명주기 이벤트에 맞춰 적절하게 동작할 수 있도록 하기 위해 맵뷰(MapView)의 생명주기 메서드를 프래그먼트나 액티비티의 생명주기 메서드 내에서 호출하는 것이 중요하다.
따라서 맵뷰의 onCreate, onResume, onPause, onDestroy, onLowMemory, onStart, onStop 등의 메서드를 각각 프래그먼트나 액티비티의 동일한 생명주기 메서드 내에서 호출하여, 맵뷰가 안드로이드 생명주기 이벤트에 맞춰 올바르게 동작하고 자원을 효율적으로 관리할 수 있도록 해야 한다.

override fun onStart() {
    super.onStart()
    mapView.onStart()
}
override fun onResume() {
    super.onResume()
    mapView.onResume()
}
override fun onPause() {
    mapView.onPause()
    super.onPause()
}
override fun onStop() {
    mapView.onStop()
    super.onStop()
}
override fun onLowMemory() {
    super.onLowMemory()
    mapView.onLowMemory()
}
override fun onSaveInstanceState(outState: Bundle) {
    super.onSaveInstanceState(outState)
    mapView.onSaveInstanceState(outState)
}
override fun onDestroyView() {
    super.onDestroyView()
    mapView.onDestroy()
    _binding = null
}

---

📖 응용

📝 마커밑에 캡션 띄우기

markers.forEach { marker ->
    marker.captionText = "장소 이름" // 실제 장소 이름으로 대체해야 합니다.
    marker.setCaptionAligns(Align.Bottom)
    marker.captionColor = Color.BLACK
    marker.captionHaloColor = Color.WHITE
    marker.captionTextSize = 16f
}

📝 확대 비율에 따른 캡션 가시성 조절

if (zoom > 14.0) {
    // 확대 레벨이 임계값 이상일 때 마커 캡션 보이기
    markers.forEach { marker ->
        marker.captionText = "장소 이름"
        marker.setCaptionAligns(Align.Bottom)
        marker.captionColor = Color.BLACK
        marker.captionHaloColor = Color.WHITE
        marker.captionTextSize = 16f
    }
} else {
    // 확대 레벨이 임계값 미만일 때 마커 캡션 숨기기
    markers.forEach { marker ->
        marker.captionText = ""
    }
}

📝 기본적으로 나오는 확대/축소 버튼 제거

오른쪽에 보이는 -/+버튼을 아래의 코드 한 줄을 onMapReady 함수 안에 적어줌으로써 제거할 수 있다.

naverMap.uiSettings.isZoomControlEnabled = false