함수 링크 복사
기본 주행 화면을 통해 길 안내를 시작합니다.
| 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() |