|
inlinestatic |
The function starts navigate to taken location.
Error | Additional error information returned from Drive. |
Location | Reference to instance of SWayPoint class which contains informations about target. |
bSearchAddress | Flag determining whether GetHistoryList searches for address or not. true - StartNavigation fills address member of each SHistoryRecord with corresponding address. false - StartNavigation does not search for address. |
MaxTime | Maximum time (in milliseconds) function can take. If MaxTime=0 function execution is not time limited. |
Flags | Parameter Flags determines route computing properties. It should be value from NavigationParams. |
bShowApplication | Flag determining whether Drive should be brought to foreground automatically. true - Drive will be brought to foreground false - Drive will stay in background |
To use this function it is necessary to have valid GPS signal and Location must be situated on loaded map. It is necessary to set Location member of Location.
Parameter Flags determines some route computing properties. Possible values are enumerated in NavigationParams enum. For example it is possible notify user that not all toll roads can be avoided.
To join more flags together use logical or operator (|). For more informations see NavigationParams enum.
It is possible to get returned (if address is returned) address by calling function
If waypoint is in restricted area , the function will return lX,lY coordinates of closest reached point in error description (truck attributes enabled) Location.GetAddress().
See Coordinates conversion section in TROUBLESHOOTING page.
Possible error codes returned from Drive are:
This code brings drive to foreground and starts navigate to taken position. If not toll roads can be avoided Drive notify user about this.
After function execution Location.GetAddress function returns destination address.
References SWayPoint.SizeOf(), and SError.SizeOf().