KNGuidance_GuideStateDelegate

INFO

This English reference is based on Directions SDK 1.12.12. For the latest version, see the Korean reference.

• Declared in: KNGuidance.h

A delegate that represents the guidance state. Called when the guidance state changes while driving. All callbacks are delivered on the main thread.

Methods

guidanceCheckingRouteChange

Called when the route changes. This is the point at which the "traffic change detected" voice guidance occurs.

- (void) guidanceCheckingRouteChange: (KNGuidance *) aGuidance

Parameters

Name	Description
aGuidance	Route guidance feature and route information

guidance:didUpdateRoutes:multiRouteInfo

Called when the route changes due to other factors while driving. It operates independently of guidanceRouteUnchanged and guidanceRouteChanged, and may be called even for the same route if the route data has changed. This callback occurs when integrating with KNMapView, and you must update the route data in KNMapView.

- (void) guidance: (KNGuidance *) aGuidance
didUpdateRoutes: (NSArray<KNRoute*> *) aRoutes
multiRouteInfo: (KNMultiRouteInfo *_Nullable) aMultiRouteInfo

Parameters

Name	Description
aGuidance	Route guidance feature and route information
aRoutes	List of routes. Up to two routes can be delivered, consisting of the main route and the alternative route in order (the alternative route can be omitted).
aMultiRouteInfo	Alternative route information (when alternative route information exists)

guidanceGuideEnded

Called when route guidance ends. This is the point at which the "destination reached, guidance ended" voice guidance occurs.

- (void) guidanceGuideEnded: (KNGuidance *) aGuidance

Parameters

Name	Description
aGuidance	Route guidance feature and route information

guidanceGuideStarted

Called when route guidance starts. This is the point at which the "starting guidance" voice guidance occurs.

- (void) guidanceGuideStarted: (KNGuidance *) aGuidance

Parameters

Name	Description
aGuidance	Route guidance feature and route information

guidanceOutOfRoute

Called when a new route is requested after deviating from the route. This is the point at which the "route deviation, recalculating" voice guidance occurs.

- (void) guidanceOutOfRoute: (KNGuidance *) aGuidance

Parameters

Name	Description
aGuidance	Route guidance feature and route information

guidanceRouteChanged

Called when the newly received route differs from the previously guided route. This is the point at which the "route changed, new guidance" voice guidance occurs.

- (void) guidanceRouteChanged: (KNGuidance *) aGuidance

Parameters

Name	Description
aGuidance	Route guidance feature and route information

guidanceRouteUnchanged

Called when the newly received route is identical to the previously guided route. This is the point at which the "guiding along the existing route" voice guidance occurs.

- (void) guidanceRouteUnchanged: (KNGuidance *) aGuidance

Parameters

Name	Description
aGuidance	Route guidance feature and route information

guidance:routeUnchangedWithError

Called when an error occurs in the route. In this case, even if the vehicle deviates from the existing route, the route is not recalculated, and route guidance is maintained according to the GPS signal. To recalculate the route, you must reroute manually, and a new route is guided only when the current location has deviated from the existing route.

- (void) guidance: (KNGuidance *) aGuidance
routeUnchangedWithError: (KNError *) aError

Parameters

Name	Description
aGuidance	Route guidance feature and route information
aError	Error