KNRoute

INFO

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

• Inherits from: NSObject
• Declared in:

Provides route options such as recommended route, normal roads, and highways.

Properties

Name	Description	Type
priority	Item to prioritize among the route guidance options	@property (nonatomic, readonly) KNRoutePriority priority
avoidOptions	Sections to avoid in the route	@property (nonatomic, readonly) SInt32 avoidOptions
drkey	Unique route number	-
desc	Route characteristics	@property (nonatomic, readonly) NSString *desc
isDestinationOnLeftSide	Position of the destination relative to the route YES: on the left NO: on the right (default: NO)	@property (nonatomic, readonly) BOOL isDestinationOnLeftSide
hasTheOtherSideRoute	Whether a route exists on the opposite side of the destination. This does not work on one-way roads. YES: an opposite-side route exists NO: no opposite-side route exists (default: NO)	@property (nonatomic, readonly) BOOL hasTheOtherSideRoute
totalDist	Total distance of the route (unit: m)	@property (nonatomic, readonly) SInt32 totalDist
totalTime	Total estimated time of the route (unit: seconds)	@property (nonatomic, readonly) SInt32 totalTime
totalCost	Total fee of the route (unit: KRW)	@property (nonatomic, readonly) SInt32 totalCost
containsFerryRoute	Whether the route includes a ferry segment YES: includes a ferry segment NO: does not include a ferry segment (default: NO)	@property (nonatomic, readonly) BOOL containsFerryRoute
viaLocations	List of waypoint locations in the route	@property (nonatomic, readonly) NSArray<KNLocation*> *viaLocations

Methods

aroundInfoList

Returns a list of surrounding information in the route.

TIP

Currently, only gas station information is provided.

- (NSArray<KNAroundInfo*> *_Nullable) aroundInfoList

containsSafetyZone

Returns whether the route includes a protected zone.

- (BOOL) containsSafetyZone: (KNSafetyZoneType) aSafetyZoneType

Parameters

Name	Description
aSafetyZoneType	Protected zone type

highwayRGList

Returns a list of highway information in the route.

- (NSArray<NSArray*<__kindofKNHighwayRG*> *> *_Nullable) highwayRGList

locationOfPoi

Checks whether the selected point is in the current route's waypoint list.

- (KNLocation *_Nullable) locationOfPoi:  (KNPOI *) aPoi

Parameters

Name	Description
aPoi	Waypoint

mainDirectionList

Returns a list of the main turn sections in the route.

- (NSArray<KNDirection*> *_Nullable) mainDirectionList

mainFacilityList

Returns a list of the main traffic facility sections in the route.

- (NSArray<KNRoadInfo_Facility*> *_Nullable) mainFacilityList

mainRoadList

Returns a list of the main road sections in the route.

- (NSArray<KNRoadInfo_Road*> *_Nullable) mainRoadList

remainCostFromLocation

Returns the remaining fee to a specific location during route guidance (unit: KRW).

- (SInt32) remainCostFromLocation: (KNLocation *) aLocation

Parameters

Name	Description
aLocation	Reference location

remainDistFromLocation

Returns the remaining distance to a specific location during route guidance (unit: m).

- (SInt32) remainDistFromLocation: (KNLocation *) aLocation

Parameters

Name	Description
aLocation	Reference location

remainTimeFromLocation

Displays the remaining time to a specific location during route guidance (unit: seconds).

- (SInt32) remainTimeFromLocation: (KNLocation *) aLocation

Parameters

Name	Description
aLocation	Reference location

roadEventList

Returns a list of traffic incident information in the route.

- (NSArray<KNRoadEvent*> *_Nullable) roadEventList

routePolylineWGS84

Converts the linear route coordinates in the KATEC coordinate system to the WGS84 coordinate system and returns them.

- (NSArray *) routePolylineWGS84

safetyList

Returns a list of safe driving information in the route.

- (NSArray<__kindofKNSafety*> *_Nullable) safetyList

safetyZoneList

Returns a list of protected zone sections in the route.

- (NSArray<KNSafetyZone*> *_Nullable) safetyZoneList