준비하기

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

사전 준비

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

서비스 활성화 및 APP KEY 발급

  • APP KEY 발급을 위해서는 iMPS 계정이 필요합니다. 계정이 없다면 먼저 계정을 생성해주세요.

  • iMPS Console 에서 APP을 생성합니다.

  • 생성된 APP에서 상품을 신청을 신청하시면, APP KEY를 확인할 수 있습니다.

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.20.1'
}

APP KEY 설정

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

AndroidManifest.xml에서 설정

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

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

InaviMapSdk API 호출로 설정

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

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

인증 실패 처리

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

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

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

인증 에러 코드

Code

Description

300

앱키 인증 오류

401

앱키 설정되지 않음

503

서버 연결 실패

504

서버 연결 시간 초과

500

알 수 없는 에러

Last updated

Was this helpful?