준비하기 (0.20.0 미만 버전)

아이나비 지도 SDK를 사용하기 위한 프로젝트 기본 설정 방법을 설명합니다.

0.20.0 미만 버전은 일정 시간이 지난 후 지원이 종료될 수 있습니다. 0.20.0 이상 버전으로 업그레이드를 권장합니다.

사전 준비

‌아이나비 지도 SDK를 사용하기 위해서는 인증을 위한 앱키가 필요합니다.‌

서비스 활성화 및 앱키 발급

NHN Cloud 이용자

• 앱키 발급을 위해서는 NHN Cloud 계정이 필요합니다. 계정이 없다면 먼저 계정을 생성해주세요.

• NHN Cloud Console 에서 서비스 선택 후 Application Service > Maps를 클릭합니다.

• 지도 서비스를 사용할 조직과 프로젝트를 선택 후 [확인] 버튼을 클릭합니다.

• 발급된 앱키는 NHN Cloud Console 상단 URL & Appkey 메뉴에서 확인할 수 있습니다.

LG U+ 지도 인프라 이용자

• 서비스명, 서비스 한 줄 소개, Application ID, 예상 사용량을 포함하여 [e-mail]로 문의해 주세요.

• 발급된 앱키는 보내주신 이메일로 회신 드리겠습니다.

Android Studio 프로젝트 환경 구성

아이나비 지도 SDK는 별도 저장소를 통해 배포되므로, 다음과 같이 프로젝트 및 앱 모듈 레벨의 build.gradle 파일에 저장소 설정과 아이나비 지도 SDK에 대한 의존성을 추가합니다.

/* Root Project build.gradle */
allprojects {
    repositories {
        google()
        ...
        // 아이나비 지도 저장소
        maven { url 'https://repo.inavi.com/artifactory/maps' }
    }
}

/* App Module build.gradle */
dependencies {
    implementation 'com.inavi.mapsdk:inavi-maps-sdk:0.11.0'
}

인증 유형 설정

LG U+ 지도 인프라 이용자만 해당됩니다.

AndroidManifest.xml에 다음과 같이 <meta-data>를 추가합니다.

<!-- AndroidManifext.xml -->
<manifest>
    <application>
        <meta-data
            android:name="com.inavi.mapsdk.AuthType"
            android:value="LgUplusMapInfra" />
    </application>
</manifest>

앱키 설정

발급받은 앱키를 설정할 수 있도록 아래의 두 가지 방법을 제공합니다.

앱키가 설정되지 않으면 지도 초기화 단계에서 인증 오류가 발생합니다.

AndroidManifest.xml에서 설정

AndroidManifest.xml에 다음과 같이 <meta-data>를 추가하여 앱키를 설정할 수 있습니다.

<!-- AndroidManifext.xml -->
<manifest>
    <application>
        <meta-data
            android:name="com.inavi.mapsdk.AppKey"
            android:value="YOUR_APP_KEY" />
    </application>
</manifest>

InaviMapSdk API 호출로 설정

Application 생성 시점에 동적으로 InaviMapSdk 싱글턴 객체의 함수를 호출하여 앱키를 설정할 수 있습니다.

Kotlin

InaviMapSdk.getInstance(context).appKey = "YOUR_APP_KEY"

인증 실패 처리

지도 초기화 단계에서 인증을 실패하면 SDK 내부에 등록된 콜백 함수로 에러 코드와 메시지를 전달합니다. 인증 실패에 대한 이벤트를 처리하려면 InaviMapSdk 싱글턴 객체의 authFailureCallback 속성을 아래와 같이 설정해야 합니다.

Kotlin

InaviMapSdk.getInstance(context).authFailureCallback =
    InaviMapSdk.AuthFailureCallback { errCode: Int, msg: String ->
        // 인증 실패 처리
}

authFailureCallback 속성을 별도로 설정하지 않으면 기본적으로 에러 코드와 메시지가 팝업 형태로 표출됩니다.

인증 에러 코드

Code	Description
300	앱키 인증 오류
401	앱키 설정되지 않음
503	서버 연결 실패
504	서버 연결 시간 초과
500	알 수 없는 에러