iOS SDK 가이드 - NHN Cloud 사용자 가이드

Application Service > Maps > iOS 지도 SDK 가이드

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

사전 준비

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

서비스 활성화

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

Appkey 확인

Appkey는 NHN Cloud Console 상단 URL & Appkey 메뉴에서 확인할 수 있습니다.

Project 환경 구성

아이나비 지도 SDK를 사용하기 위해서는 다음과 같은 순서로 프로젝트의 환경을 구성해주어야 합니다.

Git LFS 설치

용량이 크기 때문에 Pod 의존성 설치 전 Git Large File Storage(LFS) 설치가 필요합니다.

git-lfs가 설치되어 있지 않으면 SDK 의존성 설치가 정상적으로 진행되지 않아 빌드 시 오류가 발생합니다.

brew install git-lfs
git lfs install

Podfile 구성

아이나비 지도 SDK는 CocoaPods를 통해 배포되므로, 다음과 같이 프로젝트의 Podfile 파일에 아이나비 지도 SDK에 대한 의존성을 추가합니다.

# Podfile
target 'iNaviMapsDemo' do
  use_frameworks!
  ...
  pod 'inavi-maps-sdk'
  ...
end

SDK 설치

의존성 설정 후 Terminal에서 프로젝트 path로 이동한 다음, 아래 명령어를 실행하여 아이나비 지도 SDK를 설치합니다.

SDK 의존성 설치가 완료되었을 때 프레임워크 용량은 100MB 이상입니다.

pod install --repo-update

CocoaPods 캐시 삭제

간혹 이전에 다운로드 받은 SDK 의존성의 캐시가 남아있어 빌드에 오류가 발생할 수 있습니다.\ 아래 명령어를 통해 아이나비 지도 SDK의 CocoaPods 캐시를 삭제할 수 있습니다.

pod cache clean inavi-maps-sdk
pod update inavi-maps-sdk

Appkey 설정

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

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

1. 프로젝트 info.plist에서 설정

info.plist파일 내부에 Appkey를 설정할 수 있습니다.

<!-- info.plist -->
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    ...
    <key>iNaviAppKey</key>
    <string>YOUR_APP_KEY</string>
    ...
</dict>
</plist>

2. INVMapSdk API 호출로 설정

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

// Swift
INVMapSdk.sharedInstance().appKey = "YOUR_APP_KEY"

인증 실패

지도 초기화 단계에 인증이 실패하면 SDK 내부에서 등록된 Callback으로 에러 코드와 메시지를 전달합니다. 실패에 대한 Callback을 받으려면 [INVMapSdk] 싱글턴 객체에 [INVMapSdkDelegate]을 아래와 같이 설정해야 합니다.

// Swift
INVMapSdk.sharedInstance().delegate = self

func authFailure(_ errorCode: Int, message: String) {
    // 인증 실패 처리
}

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

인증 에러 코드

Code	Description
300	Appkey 유효하지 않음
401	Appkey 설정되지 않음
503	서버 연결 실패
504	서버 연결 시간 초과
500	알 수 없는 에러
그 외	서버 에러 (추후 정의 시 업데이트)

지도 생성하기

앱 화면에 아이나비 지도를 표출하는 방법을 설명합니다.

지도 표시

UIViewController에서 직접 [InaviMapView]를 생성하고 추가하는 예제입니다.

// Swift
import iNaviMaps

override func viewDidLoad() {
    super.viewDidLoad()

    let mapView = InaviMapView(frame: view.bounds)
    view.addSubview(mapView)
}

Interface Builder를 사용하여 지도를 추가하려면 XIB나 Storyboard에 UIView를 추가한 다음 Identity Inspector패널의 Custom Class 항목을 [InaviMapView]로 설정하면 됩니다.

지도 이벤트 설정

[INVMapViewDelegate]를 구현하고 [InaviMapView]의 delegate 속성을 설정하면 지도 클릭, 더블 클릭 등 지도와 사용자간 상호작용에 대한 이벤트를 설정할 수 있습니다.

// Swift
override func viewDidLoad() {
    super.viewDidLoad()
    ...
    mapView.delegate = self
}

func didTapMapView(_ point: CGPoint, latLng latlng: INVLatLng) {
    // point : 클릭한 지점의 화면상 좌표
    // latlng : 클릭한 지점의 지도상 좌표
}

마커 표출

마커 객체를 생성하고 position 속성과 map 속성을 설정하면 마커가 표출됩니다.

// Swift
let marker = INVMarker(position: INVLatLng(lat: 37.40219, lng : 127.11077))
marker.title = "타이틀"
marker.mapView = mapView

마커 제거

마커 객체의 map 속성을 nil로 설정하시면 마커가 제거됩니다.

// Swift
marker.mapView = nil

카메라 이동

[INVCameraUpdate]의 팩토리 메서드 또는 [INVCameraUpdateParams]를 통해 [INVCameraUpdate] 객체를 생성한 다음 [moveCamera()] 함수에 파라미터를 전달하여 호출하면 카메라가 이동됩니다.

애니메이션과 카메라 이벤트에 대한 콜백을 지원하므로, 카메라 이동을 원하는 대로 구현할 수 있습니다.

// Swift
let camUpdate = INVCameraUpdate.init(targetTo: INVLatLng(lat: 36.99473, lng : 127.81832))
camUpdate.animation = .fly
camUpdate.animationDuration = 3
mapView.moveCamera(camUpdate)

나만의 지도 스타일 만들기

Map Studio 서비스를 이용하면 폰트는 물론, 지도 색상, 범례 아이콘까지 원하는 대로 바꿔 나만의 특별한 지도를 제작할 수 있습니다. 또한, 최신 버전 SDK에서 제공하는 API를 이용하면 커스텀 스타일을 지도에 적용할 수 있습니다.

// Swift
INVMapSdk.sharedInstance().delegate = self
func authSuccess(_ customMapStyles: [INVMapStyle]) {
    // 지도 초기화 인증이 완료되면 지도 스타일 배열을 콜백으로 전달
}

// 저장된 커스텀 스타일 배열의 첫 번째 커스텀 스타일을 지도에 적용
mapView.customMapStyle = INVMapSdk.sharedInstance().savedCustomMapStyles.first