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