카카오모빌리티 디벨로퍼스 문서 카카오내비 길찾기 SDK API 레퍼런스

Constructor 링크 복사

초기값으로 설정된 KNMapCameraUpdateSwift 객체를 생성합니다.

var cameraUpdate = KNMapCameraUpdateSwift()
mapView.moveCamera(cameraUpdate)

var cameraUpdate = KNMapCameraUpdateSwift()
mapView.moveCamera(cameraUpdate)
코드가 숨겨졌습니다.

입력된 위치로 초기화된 KNMapCameraUpdateSwift 객체를 생성합니다. 카텍(KATEC) 좌표계를 사용하여 위도와 경도를 표시합니다.

static func targetTo(position: FloatPoint) -> KNMapCameraUpdate

static func targetTo(position: FloatPoint) -> KNMapCameraUpdate
코드가 숨겨졌습니다.
예시 코드 targetTo 
//현 지도 위치를 새로운 카텍 좌표(x:321384, y:533054)로 이동
var cameraUpdate = KNMapCameraUpdateSwift.targetTo(FloatPoint(x:321384, y:533054))
mapView.moveCamera(cameraUpdate)

//현 지도 위치를 새로운 카텍 좌표(x:321384, y:533054)로 이동
var cameraUpdate = KNMapCameraUpdateSwift.targetTo(FloatPoint(x:321384, y:533054))
mapView.moveCamera(cameraUpdate)
코드가 숨겨졌습니다.

입력된 줌 레벨 값으로 초기화된 KNMapCameraUpdateSwift 객체를 생성합니다.

static func zoomTo(zoom: Float) -> KNMapCameraUpdate

static func zoomTo(zoom: Float) -> KNMapCameraUpdate
코드가 숨겨졌습니다.
예시 코드 zoomTo 
// 현 지도 위치에서 새로운 줌 레벨 설정
var cameraUpdate = KNMapCameraUpdateSwift.zoomTo(5.0)
mapView.moveCamera(cameraUpdate)

// 현 지도 위치에서 새로운 줌 레벨 설정
var cameraUpdate = KNMapCameraUpdateSwift.zoomTo(5.0)
mapView.moveCamera(cameraUpdate)
코드가 숨겨졌습니다.

입력된 기울기 값으로 초기화된 KNMapCameraUpdateSwift 객체를 생성합니다. (기울기 설정 범위: 0~50)

static func tiltTo(degree: Float) -> KNMapCameraUpdate

static func tiltTo(degree: Float) -> KNMapCameraUpdate
코드가 숨겨졌습니다.
예시 코드 tiltTo 
// 현 지도 위치에서 새로운 기울기 설정
var cameraUpdate = KNMapCameraUpdateSwift.tiltTo(45.0)
mapView.moveCamera(cameraUpdate)

// 현 지도 위치에서 새로운 기울기 설정
var cameraUpdate = KNMapCameraUpdateSwift.tiltTo(45.0)
mapView.moveCamera(cameraUpdate)
코드가 숨겨졌습니다.

입력된 회전 값으로 초기화된 KNMapCameraUpdateSwift 객체를 생성합니다. (회전 각도 설정 범위: 0~360)

static func bearingTo(degree: Float) -> KNMapCameraUpdate

static func bearingTo(degree: Float) -> KNMapCameraUpdate
코드가 숨겨졌습니다.
예시 코드 bearingTo 
// 현 지도 위치에서 새로운 방향 설정
var cameraUpdate = KNMapCameraUpdateSwift.bearingTo(30.0)
mapView.moveCamera(cameraUpdate)

// 현 지도 위치에서 새로운 방향 설정
var cameraUpdate = KNMapCameraUpdateSwift.bearingTo(30.0)
mapView.moveCamera(cameraUpdate)
코드가 숨겨졌습니다.

입력된 앵커 값으로 초기화된 KNMapCameraUpdateSwift 객체를 생성하며 화면의 줌, 기울기, 회전의 기준점을 설정합니다. 기본값은 정중앙(0.5, 0.5)이며 새롭게 설정한 기준점을 중심으로 줌 레벨, 기울기, 회전 방향을 동작합니다.

화면의 값은 (x축, y축)으로 표시되며 왼쪽 아래의 모서리 값은 (0, 0), 오른쪽 위의 모서리 값은 (1, 1)입니다. 오른쪽으로 이동 시 x축 +0.1, 위쪽으로 이동 시 y축 +0.1을 합니다.

static func anchorTo(anchor: FloatPoint) -> KNMapCameraUpdate

static func anchorTo(anchor: FloatPoint) -> KNMapCameraUpdate
코드가 숨겨졌습니다.
예시 코드 anchorTo 
// 기본 값인 정중앙(0.5, 0.5)에서 새로운 카메라 기준점 설정.
var cameraUpdate = KNMapCameraUpdateSwift.anchorTo(0.5, 0.7)
mapView.moveCamera(cameraUpdate)

// 기본 값인 정중앙(0.5, 0.5)에서 새로운 카메라 기준점 설정.
var cameraUpdate = KNMapCameraUpdateSwift.anchorTo(0.5, 0.7)
mapView.moveCamera(cameraUpdate)
코드가 숨겨졌습니다.

KNMapCoordinateRegion에서 전달 받은 좌표 영역을 화면 안의 특정 사각 영역(CGRect)에 맞춥니다.

static func fitTo(region: KNCoordinateRegion, fittingRect: CGRect?) -> KNMapCameraUpdate

static func fitTo(region: KNCoordinateRegion, fittingRect: CGRect?) -> KNMapCameraUpdate
코드가 숨겨졌습니다.
예시 코드 fitTo 
let markers = mapView.getMarkers()
let routes = mapView.getRoutes()
let region = KNMapCoordinateRegion()
 
// 마커 영역 설정
region.mergeWithMarkers(markers: markers)

// 마커와 경로 영역 설정
region.mergeWithRoutes(routes: routes)
 
// 지도 내 특정 사각 영역 설정
var fittingScreenRect = screenRect
 
// 패딩(padding) 설정
fittingScreenRect = fittingScreenRect.insetBy(dx: 5.0, dy: 5.0)
 
// 마커와 경로 영역을 화면에 맞춤
let cameraUpdate = KNMapCameraUpdateSwift.tiltTo(45.0).fitTo(region, fittingScreenRect)
 
// 카메라 업데이트를 mapView에 적용
mapView.moveCamera(cameraUpdate)

let markers = mapView.getMarkers()
let routes = mapView.getRoutes()
let region = KNMapCoordinateRegion()
 
// 마커 영역 설정
region.mergeWithMarkers(markers: markers)

// 마커와 경로 영역 설정
region.mergeWithRoutes(routes: routes)
 
// 지도 내 특정 사각 영역 설정
var fittingScreenRect = screenRect
 
// 패딩(padding) 설정
fittingScreenRect = fittingScreenRect.insetBy(dx: 5.0, dy: 5.0)
 
// 마커와 경로 영역을 화면에 맞춤
let cameraUpdate = KNMapCameraUpdateSwift.tiltTo(45.0).fitTo(region, fittingScreenRect)
 
// 카메라 업데이트를 mapView에 적용
mapView.moveCamera(cameraUpdate)
코드가 숨겨졌습니다.

함수 링크 복사

지도상 현재 위치를 새로운 위치로 이동합니다. 카텍(KATEC) 좌표계를 사용하여 위도와 경도를 표시합니다.

func targetTo( position: FloatPoint ) -> KNMapCameraUpdate

position
이동할 위치의 카텍 좌표

지도상 현재 위치를 중심으로 줌 레벨을 설정합니다. (줌 레벨 설정 범위: 0.1~2000)

func zoomTo( zoom: Float ) -> KNMapCameraUpdate

zoom
지도에 적용할 줌 레벨(줌 레벨 설정 범위: 0.1~2000)

지도상 현재 위치를 중심으로 화면 기울기를 설정합니다. (기울기 설정 범위: 0~50)

func tiltTo( degree: Float ) -> KNMapCameraUpdate

degree
지도에 적용할 화면 기울기(기울기 설정 범위: 0~50)

지도상 현재 위치를 중심으로 회전 각도를 설정합니다. (회전 각도 설정 범위: 0~360)

func bearingTo( degree: Float ) -> KNMapCameraUpdate

degree
지도에 적용할 회전 각도(회전 각도 설정 범위: 0~360)

화면의 줌, 기울기, 회전의 기준점을 설정합니다. 기본값은 정중앙(0.5, 0.5)이며 새롭게 설정한 기준점을 중심으로 줌 레벨, 기울기, 회전 방향을 동작합니다.

화면의 값은 (x축, y축)으로 표시되며 왼쪽 아래의 모서리 값은 (0, 0), 오른쪽 위의 모서리 값은 (1, 1)입니다. 오른쪽으로 이동 시 x축 +0.1, 위쪽으로 이동 시 y축 +0.1을 합니다.

func anchorTo( anchor: FloatPoint ) -> KNMapCameraUpdate

anchor
기준점(x축, y축), 왼쪽 아래 모서리 값(0, 0), 오른쪽 위 모서리 값(1, 1)

KNMapCoordinateRegion에서 전달 받은 좌표 영역을 화면 안의 특정 사각 영역(CGRect)에 맞춥니다.

func fitTo( region: KNCoordinateRegion,
fittingRect: CGRect? ) -> KNMapCameraUpdate
예시 코드 fitTo 
// 줌 레벨 30, 위치(x:321384, y:533054)로 지도를 이동
let cameraUpdate1 = KNMapCameraUpdateSwift.zoomTo(30.0).targetTo(FloatPoint(x:321384, y:533054))
mapView.moveCamera(cameraUpdate1)
 
// 기울기 45, 회전 30, 줌 레벨 20, 위치(x:321384, y:533054)로 지도를 이동
let cameraUpdate2 = KNMapCameraUpdateSwift.targetTo(FloatPoint(x:321384, y:533054))
                                          .zoomTo(30.0)
                                          .bearingTo(30.0)
                                          .tiltTo(30.0)
mapView.moveCamera(cameraUpdate2)
 
// 지도를 45도 기울인 상태에서 KNMapCoordinateRegion에 설정된 경로와 마커 영역에 화면을 맞춤
let markers = mapView.getMarkers()
let routes = mapView.getRoutes()
let region = KNMapCoordinateRegion()
region.mergeWithMarkers(markers: markers)
region.mergeWithRoutes(routes: routes)

// 지도 내 특정 사각 영역 설정
var fittingScreenRect = screenRect
 
// 지도를 45도 길울인 상태에서 마커와 경로 영역을 화면에 맞춤
let cameraUpdate = KNMapCameraUpdateSwift.tiltTo(45.0).fitTo(region, fittingScreenRect)
 
// 카메라 업데이트를 mapView에 적용
mapView.animateCamera(cameraUpdate)

// 줌 레벨 30, 위치(x:321384, y:533054)로 지도를 이동
let cameraUpdate1 = KNMapCameraUpdateSwift.zoomTo(30.0).targetTo(FloatPoint(x:321384, y:533054))
mapView.moveCamera(cameraUpdate1)
 
// 기울기 45, 회전 30, 줌 레벨 20, 위치(x:321384, y:533054)로 지도를 이동
let cameraUpdate2 = KNMapCameraUpdateSwift.targetTo(FloatPoint(x:321384, y:533054))
                                          .zoomTo(30.0)
                                          .bearingTo(30.0)
                                          .tiltTo(30.0)
mapView.moveCamera(cameraUpdate2)
 
// 지도를 45도 기울인 상태에서 KNMapCoordinateRegion에 설정된 경로와 마커 영역에 화면을 맞춤
let markers = mapView.getMarkers()
let routes = mapView.getRoutes()
let region = KNMapCoordinateRegion()
region.mergeWithMarkers(markers: markers)
region.mergeWithRoutes(routes: routes)

// 지도 내 특정 사각 영역 설정
var fittingScreenRect = screenRect
 
// 지도를 45도 길울인 상태에서 마커와 경로 영역을 화면에 맞춤
let cameraUpdate = KNMapCameraUpdateSwift.tiltTo(45.0).fitTo(region, fittingScreenRect)
 
// 카메라 업데이트를 mapView에 적용
mapView.animateCamera(cameraUpdate)
코드가 숨겨졌습니다.

region
화면의 영역을 계산할 대상(경로, 마커 등)을 담은 객체
fittingRect
카메라의 상태가 업데이트 되었을 때 기준이 되는 화면의 영역