iOS SDK

iOS 어플리케이션에서 routo 지도를 활용할 수 있도록 제공되는 소프트웨어 개발 도구 입니다.

시작하기

routo iOS SDK 시작하기

1단계 신규프로젝트 생성
관련 화면

앱 개발을 위해 Xcode 에서 새로운 프로젝트를 생성합니다.(Create a new Xcode Project)

2단계 Single View App 선택
관련 화면

개발하려는 앱의 종류를 선택하고 Next를 클릭합니다.

3단계 프로젝트 정보 입력
관련 화면

원하는 Product Name 을 입력하고 Next 를 클릭하면 프로젝트 생성이 완료됩니다.

4단계 프레임워크 추가
관련 화면

생성된 프로젝트 폴더에 Framework 파일을 복사해서 붙여 넣습니다.
그리고 프로젝트 TARGETS->General 화면에서 프레임워크를 추가합니다.

5단계 환경설정
관련 화면

위치정보 사용을 위해 info.plist 에 설정을 추가합니다.
Privacy - Location When In Use Usage Description

6단계 Key 설정
관련 화면

SDK 에서 appKey 로 인증하는 방법입니다.

var mapView = PlayMapView(frame: frame);
self.view.addSubview(mapView);
mapView.setAppKey("[발급받은 appKey]");

좌표계

WGS84를 사용합니다.
예) 경도 : 126.952, 위도 : 37.5323

지도 화면 표시(지도생성)

구분 소스코드
관련 화면
// 클래스 내 변수 선언
var mapView:PlayMapView?

override func viewDidLoad() {
    // 지도 생성
    self.mapView = PlayMapView(frame: self.view.frame) // frame : 지도 화면크기
    // 델리게이트 설정
    self.mapView?.delegate = self
    // 화면 표시
    self.view.addSubview(self.mapView!)
    // AppKey 설정
    self.mapView?.setAppKey("[발급받은 appKey]")
}

초기화

구분 소스코드
관련 화면
//setting mapView
self.mapView = PlayMapView(frame: mapContainerView.frame)
self.mapView?.delegate = self
mapContainerView.addSubview(self.mapView!)
self.mapView?.setAppKey("[발급받은 appKey]")

블랙테마 설정

구분 소스코드
관련 화면

MapView의 blackTheme 설정 값을 변경하여 블랙테마 설정

public func onClickToggleTheme() {
    guard let mapView = self.mapView else { return }
    mapView.blackTheme = !mapView.blackTheme
}
blackTheme: Bool