준비하기
아이나비 지도 SDK를 사용하기 위한 프로젝트 기본 설정 방법을 설명합니다.
0.20.0 미만 버전은 일정 시간이 지난 후 지원이 종료될 수 있습니다. 0.20.0 이상 버전으로 업그레이드를 권장합니다.
사전 준비
아이나비 지도 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를 설정할 수 있도록 아래의 두 가지 방법을 제공합니다.
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 ->
// 인증 실패 처리
}
인증 에러 코드
Code
Description
300
앱키 인증 오류
401
앱키 설정되지 않음
503
서버 연결 실패
504
서버 연결 시간 초과
500
알 수 없는 에러
Last updated
Was this helpful?