Get the current route trace

Variables
final int	MSG_RI_GET_ROUTE_TRACE_AHEAD = 308

---

Detailed Description

Returns the current route trace

This function will return the current used route trace (if we are in an active navigation). The trace is returned as a list of WGS84 coordinates. Always two consecutive values of the list represent one coordinate of the trace in the order latitude followed by longitude.

Sending bundle:

Key	Value	Type	Info
OnlyToNextStop	Not supported anymore. Flag whether the trace should end at the next stop or at the last stop	Boolean

Return bundle:

Key	Value	Type	Info
Positions	The latitude and longitude ordinates of the route trace	DoubleArray

Returned error codes:

RI_ERROR_NONE if everything is ok.
RI_ERROR_RI_DISABLED if the Remote Interface service is disabled and/or not licensed.
RI_ERROR_NOT_INITIALIZED if the Remote Interface service is not initialized yet.
RI_ERROR_NO_ROUTE_FOUND if no route trace is currently available.
RI_ERROR_NO_LICENSE if the navigator has no valid license