[Android/Kotlin] 네이버 지도 API 연동

📌 Application 사용 가이드: https://guide.ncloud-docs.com/docs/ko/naveropenapiv3-application

📌 네이버 지도 안드로이드 SDK: https://navermaps.github.io/android-map-sdk/guide-ko/1.html

📌 네이버 지도 검색 참고사항: https://developers.naver.com/docs/serviceapi/search/local/local.md#%EC%B0%B8%EA%B3%A0-%EC%82%AC%ED%95%AD

 

초기 설정 (클라이언트 아이디 발급)

1. 콘솔로 이동

https://console.ncloud.com/naver-service/application

 

2. 좌측 상단의 Application 등록 버튼 클릭

 

3. Maps 서비스 중 원하는 내용 선택

 

4. 하단 서비스 환경 등록에서 Android 앱 패키지 이름에 현재 작업 중인 프로젝트 패키지명 입력

 

5. 등록 버튼 클릭

 

6. 인증 정보에서 클라이언트 아이디와 클라이언트 시크릿 확인 가능

 

 

안드로이드 스튜디오 설정

1. 의존성 추가

네이버 지도 SDK는 https://naver.jfrog.io/artifactory/maven/ Maven 저장소에서 배포

settings.gradle 파일에 저장소 설정 추가

❗네이버 지도 SDK 안드로이드 문서 내에서 루트 프로젝트의 build.gradle에 저장소 설정을 추가하라고 했는데, 안드로이드 스튜디오 Bumblebee 버전 이상에서는 settings.gradle 파일에 저장소 설정을 추가해야 한다.

🔗 안드로이드 Gradle 플러그인 7.1.0 관련 문서: https://developer.android.com/studio/past-releases/past-agp-releases/agp-7-1-0-release-notes?hl=ko#settings-gradle

repositories {
    google()
    mavenCentral()
    maven("https://naver.jfrog.io/artifactory/maven/")
}

 

2. 클라이언트 ID 지정

AndroidManifest.xml 파일 내 <meta-data>로 클라이언트 ID 지정

이렇게 하면 네이버 지도를 호출할 때마다 클라이언트 ID를 입력할 필요가 없다.

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

 

지도 표시

<androidx.fragment.app.FragmentContainerView
    android:id="@+id/map_fragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:name="com.naver.maps.map.MapFragment" />