컨트롤과 제스처

사용자가 컨트롤과 제스처를 통해 지도와 상호 작용하도록 하는 방법을 설명합니다.

Previous지도와 상호작용하기 Next지도 이벤트

Last updated 5 years ago

Was this helpful?

컨트롤과 제스처

사용자가 컨트롤과 제스처를 통해 지도와 상호 작용하도록 하는 방법을 설명합니다.

UiSettings

지도상에 표출되는 UI 요소와 관련된 설정을 담당하며, 해당 클래스의 속성을 변경하여 UI 요소를 제어할 수 있습니다.

객체 접근

클래스는 함수 호출을 통해서만 인스턴스를 얻을 수 있습니다.

val uiSettings = inaviMap.uiSettings

컨트롤

지도 위에 배치되어 표출 중인 지도의 정보 또는 지도의 조작을 담당하는 버튼을 의미합니다. 아이나비 지도 SDK는 나침반, 축척 바, 줌 컨트롤러 등 기본 컨트롤을 제공합니다.

컨트롤 종류

나침반 현재 표출 중인 지도의 방향을 나타냅니다. 지도가 정북인 경우는 표출되지 않습니다. 클릭하면 베어링 각도가 0으로 초기화되며, 지도가 정북 방향으로 변경됩니다.

축척 바 현재 표출 중인 지도의 축척을 나타냅니다.

줌 컨트롤러 줌 레벨을 1 단계 확대, 축소합니다.

현위치 클릭하면 사용자의 위치 확인 모드가 변경됩니다.

컨트롤 속성 변경

각 컨트롤의 표출 여부를 담당하는 속성 및 기본값은 다음과 같습니다.

컨트롤 종류

속성

기본값

나침반

true

축척 바

true

줌 컨트롤러

false

현위치 버튼

false

uiSettings.isCompassVisible = false // 나침반 숨김
uiSettings.isScaleBarVisible = false // 축척 바 숨김
uiSettings.isZoomControlVisible = true // 줌 컨트롤러 표출
uiSettings.isLocationButtonVisible = true // 현위치 버튼 표출

제스처

사용자는 제스처를 통해 아이나비 지도를 직관적으로 조작할 수 있습니다. 예를 들면 두 손가락을 벌리거나 오므려서 지도를 확대/축소하거나, 두 손가락을 위 또는 아래로 움직여 지도의 기울기를 조절할 수 있습니다. 또한 각 제스처를 활성화 또는 비활성화 하여 필요한 제스처만을 사용하도록 설정할 수 있습니다.

제스처 종류

스크롤 한 손가락으로 지도를 드래그하여 카메라 위치를 변경할 수 있습니다.
확대/축소 두 손가락을 벌려서 지도를 확대하고, 오므려서 지도를 축소할 수 있습니다.
회전 두 손가락을 시계 방향 또는 반시계 방향으로 돌려 카메라의 베어링 각도를 변경할 수 있습니다.
기울기 조절 두 손가락을 위 또는 아래로 움직여 카메라의 기울기 각도를 조절할 수 있습니다.

제스처 속성 변경

각 제스처의 활성화 여부를 담당하는 속성 및 기본값은 다음과 같습니다.

제스처 종류

속성

기본값

스크롤

true

확대/축소

true

회전

true

기울기 조절

true

uiSettings.isScrollGesturesEnabled = false // 스크롤 제스처 비활성화
uiSettings.isZoomGesturesEnabled = true // 확대, 축소 제스처 활성화
uiSettings.isRotateGesturesEnabled = false // 회전 제스처 비활성화
uiSettings.isTiltGesturesEnabled = false // 기울기 조절 제스처 비활성화

Previous지도와 상호작용하기 Next지도 이벤트

Last updated 5 years ago

Was this helpful?