[Kotlin][Android] 안드로이드 카카오맵 API 사용하기 - 카카오맵 화면에 띄우기

안녕하세요

오늘은 카카오 맵 API를 활용하는 기본적인 방법에 대해

포스팅해보려  합니다.

위치정보를 이용할 수 있는 API는 많지만 저는 개인적으로 카카오 맵이 문서가 잘 정리되어있다고 

생각하여 사용하게 되었습니다.

 

그럼 바로 사용방법을 알아볼까요??

---

API 설정

 

1. 먼저 Kakao Developers로 가서 로그인을 해줍니다.

Kakao Developers

 

2. 내 애플리케이션으로 들어가 앱을 추가해줍니다.

애플리케이션 추가 화면

 

3. 생성된 앱에서 플랫폼을 등록해줍니다.

플랫폼 등록화면

플랫폼 등록시에 패키지명은 AndroidManifest파일의 package명을 복사해서 붙여 넣으시면 됩니다.

마켓 URL은 배포시에 제공된 URL을 입력하면 되고 배포를 하지 않은 경우 생략 가능합니다.

 

마지막으로 키 해시를 입력해야 하는데 해당 값은 아래 코드를 입력 후 로그에 출력된 해쉬 키를 붙여 넣으시면 됩니다.

 

private fun getHashKey() {
        var packageInfo : PackageInfo = PackageInfo()
        try {
            packageInfo = packageManager.getPackageInfo(packageName, PackageManager.GET_SIGNATURES)
        } catch (e: PackageManager.NameNotFoundException){
            e.printStackTrace()
        }

        for (signature: Signature in packageInfo.signatures){
            try{
                var md: MessageDigest = MessageDigest.getInstance("SHA")
                md.update(signature.toByteArray())
                Log.e("KEY_HASH", Base64.encodeToString(md.digest(), Base64.DEFAULT))
            } catch(e: NoSuchAlgorithmException){
                Log.e("KEY_HASH", "Unable to get MessageDigest. signature = " + signature, e)
            }
        }
    }

키 해시가 뜨는 로그

---

APP 설정

 

apis.map.kakao.com/android/guide/

위 링크에 접속하여

SDK 다운

SDK를 다운 받아 줍니다. 다운로드한 SDK의 압축을 해제하고

main 밑에 jniLibs이름으로 폴더를 생성하여 .so 파일들을 복사해주고

libs폴더 밑에 jar파일을 복사해서 넣어줍니다.

SDK 폴더 구조

 

1. build.gradle 설정하기

// KakaoMap
    implementation files('libs/libDaumMapAndroid.jar')
    implementation fileTree(include: ['*.jar'], dir: 'libs')

 

2. Manifest 설정하기

<application
        android:allowBackup="true"
        android:dataExtractionRules="@xml/data_extraction_rules"
        android:fullBackupContent="@xml/backup_rules"
        android:icon="@mipmap/beach_icon"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.BeachCongetionPJ"
        android:usesCleartextTraffic="true" // http url 사용을 위한 설정
        android:networkSecurityConfig="@xml/network_security_config"
        tools:targetApi="31">

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="true">
        <trust-anchors>
            <certificates src="system" />
        </trust-anchors>
    </base-config>
</network-security-config>

// Manifest의 android:networkSecurityConfig를 설정

//권한 설정   
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>

 // 앱키 설정
 <activity
            android:name=".ui.MainActivity"
            android:exported="true">

            <meta-data
                android:name="android.app.lib_name"
                android:value="" />
        </activity>
        <meta-data
            android:name="com.kakao.sdk.AppKey"
            android:value=""
            />
    </application>

위에서 AppKey는 반드시 activity외부 application내부에 있어야 합니다.

아울러, value에 들어갈 앱 키는 아래 중 네이티브 앱 키를 붙여 넣으시면 됩니다.

---

카카오 맵 띄우기

마지막으로 앱에서 지도를 띄우는 방법을 확인해보겠습니다.

 

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

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

</androidx.constraintlayout.widget.ConstraintLayout>

import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import com.lee.beachcongetion.databinding.ActivityTestBinding
import net.daum.mf.map.api.MapView

class TestActivity : AppCompatActivity(){
    private lateinit var binding : ActivityTestBinding
    private lateinit var mMap : MapView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityTestBinding.inflate(layoutInflater).also {
            setContentView(it.root)
        }
        mMap = MapView(this@TestActivity) // MapView 생성
        binding.mapView.addView(mMap)// FrameLayout에 MapView add
    }
}

실행화면

이상으로 카카오 맵 API 사용하여 맵 띄우는 방법을 마치도록 하겠습니다.

다음 포스팅으론 키워드를 통해 POI 정보를 활용하는 방법에 대해 포스팅하도록 하겠습니다. 😎

 

오늘도 즐코하세요 :)