[방광곡곡] 카카오 Map 현재 위치 불러올 때 딜레이 해결 방법

1️⃣  문제 상황

안드로이드 앱에서 사용자의 현재 위치를 지도에 표시하는 기능을 구현하던 중, 매번 위치를 새로 불러오게 됨.

특히, 앱을 다시 시작할 때마다 위치를 새로 가져오는 과정에서 딜레이가 발생

 

2️⃣ 문제 원인

앱이 시작될 때마다 위치를 매번 새로 가져오는 fusedLocationClient.getCurrentLocation() 메서드 사용 했기 때문.

 

• GPS 신호가 약하거나 네트워크 상태가 불안정한 경우
• 위치 정보가 자주 변경되지 않는 상황에서는 불필요한 자원 소모가 발생

 

따라서, 이러한 문제를 해결하기 위해서는 위치 정보를 캐싱하여 저장하고, 필요할 때만 업데이트하는 방식이 필요합니다.

 

3️⃣ 해결 방법

1. SharedPreferences를 사용하여
2. 마지막으로 가져온 위치를 저장하고
3. 앱이 시작될 때 이를 불러와 초기 위치로 설정
4. 캐싱된 위치와 현재 위치를 비교하여 다른 경우에만 지도 중심 업데이트, SharedPreferences 갱신

이를 통해 앱 시작 시 빠르게 지도에 위치를 표시할 수 있으며, 필요할 때만 새로운 위치 정보를 업데이트하도록 하였습니다.

 

 

1. SharedPreferences 초기화

val sharedPreferences = getSharedPreferences("LocationCache", MODE_PRIVATE)

• 원리: 
  • SharedPreferences는 간단한 키-값 쌍을 저장하는 데 사용됩니다.
  • 여기서는 "LocationCache"라는 이름의 SharedPreferences 객체를 초기화하여 위치 데이터를 저장하고 불러올 수 있도록 합니다.
  • MODE_PRIVATE는 이 데이터가 앱 내에서만 사용 가능하도록 설정합니다.

 

2. 이전에 저장된 위치 가져오기

val cachedLatitude = sharedPreferences.getString("latitude", null)?.toDoubleOrNull()
val cachedLongitude = sharedPreferences.getString("longitude", null)?.toDoubleOrNull()

• 원리:
  • 이전에 저장된 위도와 경도 값을 SharedPreferences에서 불러옵니다.
  • 저장된 값이 없을 경우 null을 반환합니다.
  • 문자열로 저장된 값을 Double로 변환하여 사용할 수 있도록 합니다.

 

3. 캐싱된 위치로 지도 설정

if (cachedLatitude != null && cachedLongitude != null) {
    val cachedPosition = LatLng.from(cachedLatitude, cachedLongitude)
    kakaoMap.moveCamera(CameraUpdateFactory.newCenterPosition(cachedPosition, 16))
    addMarkerToMap(cachedPosition, null)
}

 

• 원리:
  • 저장된 위치가 존재할 경우,
    • 이를 LatLng 객체로 변환하여 지도 중심을 설정합니다.
    •  moveCamera 메서드를 통해 지도의 중심을 캐싱된 위치로 이동시키고, 
    • addMarkerToMap 메서드를 사용하여 해당 위치에 마커를 추가합니다.

 

4. 위치 권한 확인

if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) {
    // 위치 업데이트 주기를 조절하여 필요할 때만 위치를 가져옴
}

• 원리:
  • 사용자가 위치 권한을 허용했는지 확인합니다. 
  • ACCESS_FINE_LOCATION 권한이 허용된 경우에만 위치 정보를 가져옵니다.
  • 이는 사용자 프라이버시를 보호하고, 앱이 불필요한 오류를 발생시키지 않도록 합니다.

 

5-1. 현재 위치 요청

fusedLocationClient.getCurrentLocation(Priority.PRIORITY_BALANCED_POWER_ACCURACY, null)
    .addOnSuccessListener { location ->
        // 위치를 성공적으로 가져왔을 때 실행되는 코드
    }
    .addOnFailureListener {
        // 위치를 가져오는 데 실패했을 때 실행되는 코드
    }

• 원리:
  • fusedLocationClient.getCurrentLocation() 메서드를 사용하여 현재 위치를 가져옵니다. 
  • PRIORITY_BALANCED_POWER_ACCURACY는 배터리 소모를 고려하여 적절한 정확도로 위치를 가져옵니다.
    • 성공 시: 위치를 성공적으로 가져오면 addOnSuccessListener가 실행됩니다
    • 실패 시: 위치를 가져오는 데 실패하면 addOnFailureListener가 실행되어 사용자에게 오류 메시지를 표시합니다.

 

5-2. 위치 객체 처리

location?.let {
    val currentPosition = LatLng.from(it.latitude, it.longitude)
    // 이후 코드에서 currentPosition을 사용
}

• 원리:
  • 위치 객체가 null이 아닌 경우에만 처리합니다. 
  • let 블록을 사용하여 location 객체의 위도와 경도를 LatLng 객체로 변환합니다.
  • 이 객체는 지도 중심을 설정하거나 마커를 추가하는 데 사용됩니다.

 

5.3 위치 변경 여부 판단

val isLocationChanged = cachedPosition?.let { cachedPos ->
    val cachedLocation = Location("").apply {
        latitude = cachedPos.latitude
        longitude = cachedPos.longitude
    }
    val currentLocation = Location("").apply {
        latitude = it.latitude
        longitude = it.longitude
    }
    cachedLocation.distanceTo(currentLocation) > 10 // 10 meters threshold
} ?: true

• 원리:
  • 캐싱된 위치와 현재 위치 비교: Location 객체를 사용하여 두 위치 간의 거리를 계산합니다.
  • 거리 기준: distanceTo() 메서드를 사용하여 두 위치 간의 거리를 계산하고, 이 값이 10미터보다 큰 경우에만 위치가 변경된 것으로 판단합니다.
  • 기본값: 캐싱된 위치가 없을 경우(cachedPosition이 null인 경우), 위치가 변경된 것으로 간주하여 true를 반환합니다.

 

5.4 위치 변경 시 지도 업데이트

if (isLocationChanged) {
    // 현재 위치로 지도 중심 설정
    kakaoMap.moveCamera(CameraUpdateFactory.newCenterPosition(currentPosition, 16))
    addMarkerToMap(currentPosition, null)

    // 새로운 위치를 캐싱
    val editor = sharedPreferences.edit()
    editor.putString("latitude", it.latitude.toString())
    editor.putString("longitude", it.longitude.toString())
    editor.apply()
}

 

• 원리:
  • 지도 업데이트:
    • 위치가 변경된 경우에만 moveCamera 메서드를 사용하여 지도의 중심을 새로운 위치로 설정하고, 
    • addMarkerToMap 메서드를 사용하여 해당 위치에 마커를 추가합니다.
  • 위치 저장: 
    • SharedPreferences에 새로운 위치를 저장하여 이후에 앱이 다시 시작될 때 이 위치를 사용할 수 있도록 합니다. 
    • apply() 메서드를 사용하여 비동기적으로 저장합니다.

 

4️⃣ 그 과정에서 발생한 문제

1. LatLng 객체 생성 에러:

cannot access "init" it is private in LatLng

 

kakao.vector~ import해도 계속 에러 남.

LatLng(a,b) -> LatLng.from(a,b) 로 해결

이를 해결하기 위해 from() 메서드를 사용하여 객체를 생성했습니다.

 

1. 위치 권한 문제: 위치 정보를 가져오기 위해서는 반드시 위치 권한이 필요합니다. 권한이 없는 경우 앱이 정상적으로 작동하지 않을 수 있습니다.
2. 위치 업데이트 주기 설정: 너무 자주 위치를 업데이트하면 배터리 소모가 증가할 수 있습니다. 적절한 주기로 위치를 업데이트하도록 설정해야 합니다.

 

5️⃣ 전체코드

개선 코드 전

private fun setMapToCurrentLocation() {
    if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) {
        fusedLocationClient.getCurrentLocation(Priority.PRIORITY_HIGH_ACCURACY, null)
            .addOnSuccessListener { location ->
                location?.let {
                    val currentPosition = LatLng(it.latitude, it.longitude)
                    kakaoMap.moveCamera(CameraUpdateFactory.newCenterPosition(currentPosition, 16))
                    addMarkerToMap(currentPosition, null)
                }
            }
    }
}

 

개선 코드 후

import android.location.Location

private fun setMapToCurrentLocation() {
    val sharedPreferences = getSharedPreferences("LocationCache", MODE_PRIVATE)

    // 이전에 저장된 위치 가져오기 (위도, 경도)
    val cachedLatitude = sharedPreferences.getString("latitude", null)?.toDoubleOrNull()
    val cachedLongitude = sharedPreferences.getString("longitude", null)?.toDoubleOrNull()

    var cachedPosition: LatLng? = null
    if (cachedLatitude != null && cachedLongitude != null) {
        cachedPosition = LatLng.from(cachedLatitude, cachedLongitude)
        kakaoMap.moveCamera(CameraUpdateFactory.newCenterPosition(cachedPosition, 16))
        addMarkerToMap(cachedPosition, null)
    }

    // 위치 권한이 허용되었는지 확인
    if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) {
        fusedLocationClient.getCurrentLocation(Priority.PRIORITY_BALANCED_POWER_ACCURACY, null)
            .addOnSuccessListener { location ->
                location?.let {
                    val currentPosition = LatLng.from(it.latitude, it.longitude)

                    // 이전 위치와 현재 위치 비교, 거리 차가 10미터 이상인 경우만 
                    //초기값이 null인 경우는 바로 true
                    val isLocationChanged = cachedPosition?.let { cachedPos ->
                        val cachedLocation = Location("").apply {
                            latitude = cachedPos.latitude
                            longitude = cachedPos.longitude
                        }
                        val currentLocation = Location("").apply {
                            latitude = it.latitude
                            longitude = it.longitude
                        }
                        cachedLocation.distanceTo(currentLocation) > 10 // 10 meters threshold
                    } ?: true

                    if (isLocationChanged) {
                        // 현재 위치로 지도 중심 설정
                        kakaoMap.moveCamera(CameraUpdateFactory.newCenterPosition(currentPosition, 16))
                        addMarkerToMap(currentPosition, null)

                        // 새로운 위치를 캐싱
                        val editor = sharedPreferences.edit()
                        editor.putString("latitude", it.latitude.toString())
                        editor.putString("longitude", it.longitude.toString())
                        editor.apply()
                    }
                }
            }
            .addOnFailureListener {
                Toast.makeText(this, "현재 위치를 가져올 수 없습니다.", Toast.LENGTH_SHORT).show()
            }
    }
}

 

여기서 총 addMarkToMap이 2번 호출되는데, 

1번 addMarkToMap에서 캐싱된 위치로 마커 추가,

2번 addMarkToMap으로 우치 차이가 10이상인 경우 지도에 다시 마크를 추가(업데이트), SharedPreferences 값 갱신