함수 링크 복사
기본 주행 화면을 통해 길 안내를 시작합니다.
fun initWithGuidance( | guidance: | KNGuidance, | |
trip: | KNTrip?, | ||
routePriority: | KNRoutePriority, | ||
avoidOptions: | Int | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
- trip
- 주행에 사용할 경로
- routePriority
- 길 안내 선정 시 우선적 고려할 사항
- avoidOptions
- 경로에서 회피하고 싶은 구간
3D 백터 지도를 표시하는 mapComponent
의 지도 테마(mapTheme
)를 변경합니다.
fun changeDisplayType( | displayType: | KNDisplayType | ): Unit |
길 안내를 시작합니다. KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceGuideStated()
의 내용을 KNNaviView
에 전달합니다.
fun guidanceGuideStarted( | guidance: | KNGuidance | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
경로의 변화를 감지합니다. 교통 변화, 경로 이탈로 인한 경로 재탐색이나 사용자가 경로를 재탐색할 때 호출됩니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceCheckingRouteChange()
의 내용을 KNNaviView
에 전달합니다.
fun guidanceCheckingRouteChange( | guidance: | KNGuidance | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
기존 경로를 유지합니다. 교통 변화를 감지한 뒤 경로 변화가 없거나, 교통 상황의 변화로 요청한 새로운 경로가 기존의 경로와 동일할 경우 호출됩니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceRouteUnchanged()
의 내용을 KNNaviView
에 전달합니다.
fun guidanceRouteUnchanged( | guidance: | KNGuidance | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
경로 요청에 실패 시 에러 메시지를 반환합니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceRouteUnchangedWithError()
의 내용을 KNNaviView
에 전달합니다.
fun guidanceRouteUnchangedWithError( | guidance: | KNGuidance, | |
error: | KNError | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
- error
- 경로 요청 실패 에러
기존 경로를 이탈합니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceOutOfRoute()
의 내용을 KNNaviView
에 전달합니다.
fun guidanceOutOfRoute( | guidance: | KNGuidance | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
경로 변경를 전달합니다. 여러 개의 경로 중 첫 번째 경로가 주행 경로이며 나머지는 대안 경로가 됩니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceRouteChanged()
의 내용을 KNNaviView
에 전달합니다.
fun guidanceRouteChanged( | guidance: | KNGuidance | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
길 안내가 종료됩니다. KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceGuideEnded()
의 내용을 KNNaviView
에 전달합니다. 길 안내 종료를 안내하는 팝업 메시지 표시 여부 설정도 할 수 있습니다.
fun guidanceGuideEnded( | guidance: | KNGuidance | |
isShowDriveResultDialog: | Boolean | ) |
- guidance
- 길 안내 기능 및 경로 정보
- isShowDriveResultDialog
- 길 안내 종료 팝업 메시지 표시 여부(기본값: true)
기존 경로가 변경됩니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceDidUpdateRoutes()
의 내용을 KNNaviView
에 전달합니다.
fun guidanceDidUpdateRoutes( | guidance: | KNGuidance, | |
routes: | List<KNRoute>, | ||
multiRouteInfo: | KNMultiRouteInfo? | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
- routes
- 경로 정보 목록
- multiRouteInfo
- 대안 경로 정보
위치 정보를 업데이트합니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceDidUpdateLocation()
의 내용을 KNNaviView
에 전달합니다.
fun guidanceDidUpdateLocation( | guidance: | KNGuidance, | |
locationGuide: | KNGuide_Location | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
- locationGuide
- 위치 정보
경로 안내 정보의 상세 항목 중 한 개 이상의 항목이 변경될 때 전달됩니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceDidUpdateRouteGuide()
의 내용을 KNNaviView
에 전달합니다.
fun guidanceDidUpdateRouteGuide( | guidance: | KNGuidance, | |
routeGuide: | KNGuide_Route | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
- routeGuide
- 경로 안내 정보
안전 운행 안내 정보의 상세 항목 중 한 개 이상의 항목이 변경될 때 전달됩니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceDidUpdateSafetyGuide()
의 내용을 KNNaviView
에 전달합니다.
fun guidanceDidUpdateSafetyGuide( | guidance: | KNGuidance, | |
safetyGuide: | KNGuide_Safety? | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
- safetyGuide
- 안전 운행 안내 정보
주변의 안전 운행 정보 데이터를 전달합니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 guidanceDidUpdateAroundSafeties()
의 내용을 KNNaviView
에 전달합니다.
fun guidanceDidUpdateAroundSafeties( | guidance: | KNGuidance, | |
safeties: | List<KNSafety>? | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
- safeties
- 안전 운행 정보 리스트
음성 안내 재생 여부를 반환합니다. false
반환 시 음성 안내가 재생되지 않습니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 shouldPlayVoiceGuide()
의 내용을 KNNaviView
에 전달합니다.
길 안내 중 백그라운드 모드로 전환 시 음성 안내는 종료되지 않습니다.
fun shouldPlayVoiceGuide( | guidance: | KNGuidance, | |
voiceGuide: | KNGuide_Voice, | ||
newData: | MutableList<ByteArray> | ): Boolean |
- guidance
- 길 안내 기능 및 경로 정보
- voiceGuide
- 음성 안내 정보
- newData
- 기존 음성을 대체할 새로운 음성 데이터 리스트
음성 안내를 재생합니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 willPlayVoiceGuide()
의 내용을 KNNaviView
에 전달합니다.
fun willPlayVoiceGuide( | guidance: | KNGuidance, | |
voiceGuide: | KNGuide_Voice | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
- voiceGuide
- 음성 안내 정보
음성 안내를 종료합니다.
KNGuidance
의 가이던스 상태 델리게이트(guideStateDelegate
)에 의해 호출되는 didFinishPlayVoiceGuide()
의 내용을 KNNaviView
에 전달합니다.
fun didFinishPlayVoiceGuide( | guidance: | KNGuidance, | |
voiceGuide: | KNGuide_Voice | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
- voiceGuide
- 음성 안내 정보
안전 운행 모드를 종료하고 새로운 길 안내를 시작합니다.
fun guideNewDestinations( | trip: | KNTrip, | |
priority: | KNRoutePriority?, | ||
avoidOption: | Int? | ) |
- trip
- 길 안내할 경로
- priority
- 경로 탐색 우선순위 옵션
- avoidOption
- 경로 탐색 제한 옵션
길 안내를 종료하고 안전 운행 모드로 전환합니다.
fun guideCancel() |