Skip to content

Frequently Asked Questions

FAQs

  • Q: Should I always use matched location for current vehicle location rendering on map?
    A: It's recommended to use LocationInfo::matched_location if RoadInfo::bearing_aligned in Indicator::matched_road is true. Otherwise, use LocationInfo::raw_location instead.

  • Q: How many locales does drive session support for audio guidance prompt?
    A: Following is the list of locales supported

locale code language name turn-by-turn navigation alert and violation event
ar Arabic supported supported
cs_CZ Czech supported supported
da_DK Danish supported supported
de_DE German supported supported
el_GR Greek supported supported
en_AU English (Australia) supported supported
en_GB English (United Kingdom) supported supported
en_US English (United States) supported supported
es_ES Spanish (Spain) supported supported
es_MX Spanish (Mexico) supported supported
fi_FI Finnish supported supported
fr_CA French (Canada) supported supported
hr_HR Croatian supported not supported
hu_HU Hungarian supported not supported
it_IT Italian supported supported
nl_NL Dutch supported supported
no_NO Norwegian supported supported
pl_PL Polish supported supported
pt_PT Portuguese (Portugal) supported supported
ro_RO Romanian supported supported
ru_RU Russian supported supported
sk_SK Slovak supported supported
sv_SE Swedish supported supported
th_TH Thai supported supported
tr_TR Turkish supported supported

  • Q: What's the meaning of a route without / with partial / with full guidance information?
    A: Guidance information is mainly for the purpose of instructing the driver to take actions during a maneuver.
    A route without guidance information indicates it only has basic information about the road segments along it. Such routes cannot be used directly for navigation, because the driver does not know where to make a turn. This kind of route is retrieved from direction service if you use CalculationMode::Onboard.
    A route with partial guidance information indicates it has guidance information for the beginning part of the route, usually the first 50 km. For the rest of the route, only basic information is available. This kind of route is provided by navigation session via NavigationEventListener::onNavigationRouteUpdating() notifications with reason being UpdateInternal if the route used to start navigation is calculated onboard.
    A route with full guidance information indicates it has guidance information for the whole route. This kind of route is retrieved from direction service if you use CalculationMode::Offboard. Another case is via NavigationEventListener::onNavigationRouteUpdating() notification for route with partial guidance information.

  • Q: Is a turn-by-turn list provided for all turns in one shot, or is it provided in delta update style?
    A: It's provided in one shot for all turns in ascending order of turn index.
    One thing to notice is that the number of turns in the list may increase between two updates for the same route.
    This happens for long routes calculated onboard. Due to the limited resources available onboard, it may take some time to gather the guidance information for long routes.
    To speed up the process from getting a route to starting navigation on it, guidance information gathering is completed in two phases. In the first phase, only a short part from the beginning of the route has guidance information updated. With this information, the drive session can start navigation on it. Meanwhile, it completes the guidance information for the remaining part of the route in the background, i.e., the second phase of gathering guidance information.

  • Q: Does navigation status still get updated when the vehicle deviates from the current route in navigation?
    A: Yes, navigation status is updated even when vehicle deviates from current route or goes off-road. However, in these cases, not all information will be updated; some information will remain the same compared to the last route the vehicle took.
    The following table shows the information update condition in navigation status.

Information Type Updated on route Updated on deviation Updated off-road
vehicle status yes yes yes
road properties yes yes no
on route information yes no no
travel information yes no no
POI information yes yes yes
navigation events yes no no

  • Q: How to tell if an alert item has been passed?
    A: Each alert item has a unique ID assigned to it, once an alert with the same ID moves from the ahead alert list to the behind alert list, it means it has been passed.

  • Q: Why do section speed cameras on some roads provide zone alerts, while others provide two-point alerts or even only partial alerts?
    A: Alert detection is performed within a limited distance. If drive session detects the whole zone affected by a section speed camera, it will provide a CameraAlert with type SectionSpeedCamera as a zone alert. Otherwise it may detect either the start or end of the zone, in this case a CameraAlert with type SectionStartCamera or SectionEndCamera as a point alert.

  • Q: What is the recommended way to show lane guidance information if there's no lane change ahead?
    A: If there's no lane change ahead, drive session will not provide any lane guidance information in this case. If you still want to show lane guidance information, you can record the LaneGuidanceNotification::nextLanes in the last lane guidance information and keep it shown until a new LaneGuidanceInfo is provided when lane changes are detected.

  • Q: What to do for a better route updated with internal reasons?
    A: RouteUpdateReason::UpdateInternal indicates a route must be updated for the TA SDK components to work correctly due to system requirements. But the detailed reason should not be cared for by the client integrating the TA SDK. When receiving a better route update progress with this reason and the status is RouteUpdateStatus::Succeeded, it is recommended to update the route silently in your application.

  • Q: Will route be updated if vehicle goes off-road?
    A: No, the navigation session does not support off-road rerouting. You can implement it yourself by checking the status of your vehicle.

  • Q: Why is saved time zero even if the estimated remaining travel time of the proposed better route is different from the one of current route in navigation?
    A: Saved time in better route proposal is only meaningful when the reason is BetterRouteReason::SaveTime. For other reasons, the benefit of the proposal is not time related.

  • Q: Why don‘t extremely urgent traffic incidents along the route trigger better route searches?
    A: Only blocking traffic incidents will trigger better route searches. Not all X-urgent traffic incidents are treated as blocking incidents. It depends on the traffic supplier.