[Android] kakao map 사용하기

🙋‍♀️ kakao sdk 사용 초기 설정

우선 기본적으로 kakao sdk 사용을 위해 프로젝트를 등록하고 app key를 받아오는 것까지 마무리했다는 가정하에 그 다음 단계부터 차근차근 정리해보고자 한다.

🙋‍♀️ kakao map sdk 다운

우선 kakao map을 사용하기 위해서는 필요한 sdk를 다운받아야 한다. 다음 공식 문서에서 sdk를 다운받아 압축을 풀어주면 다음의 폴터, 파일을 얻을 수 있다.

• libDaumMapAndroid.jar
• 아키텍쳐별로 libMapEngineApi.so 세 개의 바이너리 파일

우선 libDaumMapAndroid.jar 파일은 /app/libs/에 복사를 하고, libMapEngineApi.so 파일은 /app/source/main/jniLibs 폴더를 만들어 그 안에 복사해주면 된다.

이제 등록한 jar 파일의 dependency를 추가해줘야 한다! 우선 File -> Project Structure로 들어가 왼쪽 메뉴의 Dependencies를 클린한다. Modules 부분은 app을 선택하고 Declared Dependencies의 +를 눌러 jar dependency를 추가한다.

여기서 step1에는 src\main\jniLibs를 입력하고, step2에는 implementation을 선택한 후 Apply, Ok 버튼을 클릭해 적용을 한다.

여기까지 진행했다면 build 파일에 다음의 dependency가 추가되어 있는지 확인하자! 그리고 만약 추가되어 있지 않다면 아래의 코드를 추가해라!

    //kakao map
    implementation files('libs/libDaumMapAndroid.jar')

이제 마지막으로 manifest에서 permission 및 app key를 추가해주어야 한다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    // internet 및 location 권한⭐️
    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>

    <application
        android:usesCleartextTraffic="true // 암호화 되지 않은 서버와 통신이 필요함⭐️
        android:name=".presentation.base.GlobalApplication"
        android:allowBackup="true"
        android:dataExtractionRules="@xml/data_extraction_rules"
        android:fullBackupContent="@xml/backup_rules"
        android:icon="@drawable/ic_sopar_logo"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/Theme.Sopar.Splash"
        tools:targetApi="31">
        <activity
            android:name="com.kakao.sdk.auth.AuthCodeHandlerActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.VIEW" />
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />
                <data android:host="oauth"
                    android:scheme="kakao${NATIVE_APP_KEY}" />
            </intent-filter>
        </activity>
...

        // app key 추가⭐️
        <meta-data android:name="com.kakao.sdk.AppKey" android:value="${NATIVE_APP_KEY}"/>

    </application>
</manifest>

• 카카오 맵 api 호출에서는 http가 사용되므로 위의 usesCleartextTraffic를 true로 설정해야 한다.
• 공식문서에서는 ACCESS_FINE_LOCATION 권한만을 설정하지만 해당 권한만을 설정하면 다음의 오류가 발생하게 된다.
  • If you need access to FINE location, you must request both ACCESS_FINE_LOCATION and ACCESS_COARSE_LOCATION
  • 따라서 wifi나 기지국 신호를 기반으로 위치를 가져오는 ACCESS_COARSE_LOCATION 권한도 함께 설정해준다.

그렇다면 이제 카카오 맵을 화면에 띄어보자!

🙋‍♀️ MapView 사용하기

✓ 카카오맵 화면에 띄우기

화면에 지도를 띄우기 위해서는 net.daum.mf.map.api.MapView를 활용할 수 있다.

<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".presentation.map.MapFragment">

    <net.daum.mf.map.api.MapView
        android:id="@+id/map_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</androidx.constraintlayout.widget.ConstraintLayout>

MapView를 사용할 때는 net.daum.android.map.MapView와 헷갈리지 않도록 한다!

여기까지 진행하면 아래 사진같이 맵이 잘 출력되는 것을 확인할 수 있을 것이다.

본격적으로 맵을 사용하기 전에 필요한 권한 승인 작업이 필요하다!

✓ 권한 승인 진행하기

권한 승인은 registerForActivityResult와 ActivityResultContracts를 사용해 진행하고자 한다.

우선 권한이 승인되었는지를 먼저 ContextCompat.checkSelfPermission를 통해 확인해준다.

    private fun isAllPermissionsGranted(): Boolean = REQUIRED_PERMISSIONS.all { permission ->
        ContextCompat.checkSelfPermission(requireContext(), permission) ==
                PackageManager.PERMISSION_GRANTED
    }

만약 승인이 필요하다면 권한에 대한 승인 요청을 진행하면 된다. 우선 그 과정에서 사용할 requestPermissionLauncher를 정의해준다.

    private val requestPermissionLauncher =
        registerForActivityResult(ActivityResultContracts.RequestMultiplePermissions()) { permissions ->
            permissions.entries.forEach { permission ->
                when {
                    //권한을 승인하였을 떄
                    permission.value -> {
                        Toast.makeText(requireContext(), "필요한 권한이 승인되었습니다!", Toast.LENGTH_SHORT).show()
                    }
                    //권한을 완전히 거부했을 경우
                    shouldShowRequestPermissionRationale(permission.key) -> {
                        Toast.makeText(requireContext(), "설정에서 권한을 승인해주세요!", Toast.LENGTH_SHORT).show()
                    }
                    //권한을 승인하지 않은 경우
                    else -> {
                        Toast.makeText(requireContext(), "설정에서 권한을 승인해주세요!", Toast.LENGTH_SHORT).show()
                    }
                }
            }
        }

이제 이를 이용해 필요한 권한을 요청한다.

        if (!isAllPermissionsGranted()) {
          //필요한 권한이 승인되어 있지 않은 경우
            requestPermissionLauncher.launch(REQUIRED_PERMISSIONS)
        }

여기서 필요한 권한은 companion object 속 배열 형태로 미리 정의해주었다.

    companion object {
        private val REQUIRED_PERMISSIONS = arrayOf(
            android.Manifest.permission.ACCESS_COARSE_LOCATION,
            android.Manifest.permission.ACCESS_FINE_LOCATION,
            android.Manifest.permission.INTERNET
        )
    }

이렇게 한다면 이제 필요한 권한이 모두 승인되었다.

이제 카카오맵을 활용하는 단계만 남았다! 해당 내용에 대해서는 추후 게시글을 통해 정리해보겠다!

---

(2023.05.12) 추가 정리 부분

hilt와 함께 kakao map을 사용할 경우, xml에서 바로 MapView를 사용할 경우

Caused by: android.view.InflateException: Binary XML file line #12 in org.sopar:layout/fragment_map: Error inflating class net.daum.mf.map.api.MapView

위의 오래가 발생하게 된다. 따라서 addView를 통해 MapView를 사용하는 방식을 적용해야 한다.

   <RelativeLayout
        android:id="@+id/map_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

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

        mapView = MapView(requireActivity())
        binding.mapView.addView(mapView)
        ...

🙇‍♀️ 부족한 부분이 있다면 말씀해주세요! 감사합니다!

📃참고

• https://apis.map.kakao.com/android/guide/
• https://m.blog.naver.com/bgpoilkj/222826006726