함수 링크 복사
경로가 변경되면 호출됩니다. "교통 변화를 감지" 음성 안내가 발생하는 시점입니다.
abstract fun guidanceCheckingRouteChange( | guidance: | KNGuidance | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
주행 중 기타 요인들로 인해 경로가 변경되었을 때 호출됩니다. guidanceRouteUnchanged
, guidanceRouteChanged
와는 별개로 동작하며 동일한 경로라도 경로 데이터가 변경되었을 경우 호출될 수 있습니다. KNMapView
연동 시 해당 콜백이 발생하며 KNMapView
에 경로 데이터를 변경해 주어야 합니다.
abstract fun guidanceDidUpdateRoutes( | guidance: | KNGuidance, | |
routes: | List<KNRoute>, | ||
multiRouteInfo: | KNMultiRouteInfo? | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
- routes
- 경로 리스트. 최대 2개의 경로를 전달할 수 있으며 순서대로 주 경로, 대안 경로로 구성됨(대안 경로 생략 가능)
- multiRouteInfo
- 대안 경로 정보(대안 경로 정보가 있는 경우)
길 안내가 종료되면 호출됩니다. "목적지 도착, 안내 종료" 음성 안내가 발생하는 시점입니다.
abstract fun guidanceGuideEnded( | guidance: | KNGuidance | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
길 안내가 시작되면 호출됩니다. "안내를 시작" 음성 안내가 발생하는 시점입니다.
abstract fun guidanceGuideStarted( | guidance: | KNGuidance | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
경로에서 이탈한 뒤 새로운 경로를 요청 시 호출됩니다. "경로 이탈 재 검색" 음성 안내가 발생하는 시점입니다.
abstract fun guidanceOutOfRoute( | guidance: | KNGuidance | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
수신 받은 새 경로가 기존의 안내된 경로와 다를 경우 호출됩니다. "경로 변경, 새로운 길 안내" 음성 안내가 발생하는 시점입니다.
abstract fun guidanceRouteChanged( | guidance: | KNGuidance | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
수신 받은 새 경로가 기존의 안내된 경로와 동일할 경우 호출됩니다. "기존 경로로 안내" 음성 안내가 발생하는 시점입니다.
abstract fun guidanceRouteUnchanged( | guidance: | KNGuidance | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
경로에 오류가 발생 시 호출됩니다. 이 경우, 기존의 경로를 이탈하더라도 경로를 재탐색하지 않으며 GPS 신호를 따라 길 안내를 유지합니다. 다시 경로를 탐색하려면, 수동으로 경로를 재탐색해야 하며 현재 위치가 기존의 경로에서 벗어났을 경우에만 새로운 경로를 안내합니다.
abstract fun guidanceRouteUnchangedWithError( | guidance: | KNGuidance, | |
error: | KNError | ): Unit |
- guidance
- 길 안내 기능 및 경로 정보
- error
- 오류