com.tomtom.navapp

Interface Utils

public interface Utils

NavApp Utils interface. Contains various utility APIs to for example access information related to the map.

Since:

1

Method Summary

Methods

Modifier and Type	Method and Description
void	getMapInfo(MapInfo.Listener callback) Get information about the currently active map on the device.
void	getVehicleProfile(VehicleProfile.Listener listener) Get information about the currently active VehicleProfile.
void	setVehicleProfile(VehicleProfile profile, VehicleProfile.Listener listener) Set information to the currently active VehicleProfile.

Method Detail

getMapInfo

void getMapInfo(MapInfo.Listener callback)

Get information about the currently active map on the device. The passed in listener is only active until the result of the call has been returned. Once a result has been returned the listener won't receive any more callbacks (but can be re-used). If there's currently no active map, the listener will return null.

Parameters:

callback - The MapInfo.Listener to receive map information.

Throws:

java.lang.IllegalArgumentException - if the listener is null.

Since:

1

getVehicleProfile

void getVehicleProfile(VehicleProfile.Listener listener)

Get information about the currently active VehicleProfile. The passed in listener is only active until the result of the call has been returned. Once a result has been returned the listener won't receive any more callbacks (but can be re-used).

Parameters:

listener - The VehicleProfile.Listener to receive vehicle profile information.

Throws:

java.lang.IllegalArgumentException - if the listener is null.

Since:

4

setVehicleProfile

void setVehicleProfile(VehicleProfile profile,
                     VehicleProfile.Listener listener)

Set information to the currently active VehicleProfile. If no profile is currently active, a new one will be created and updated. An empty VehicleProfile object can be created with a call to NavAppClient.makeVehicleProfile(). The object can then be initialized by setting the desired attributes (e.g. setAttributeLong, setAttributeString and so on). For a list of available attributes, see the documentation of VehicleProfile. Attributes that have not been specified will be left unchanged in the application, but a consistency check will be performed before accepting the modification (e.g. if we are only setting the vehicle type as "CAR", the list of hazardous material already set in the application must be empty). The passed in listener is only active until the result of the call has been returned. Once a result has been returned the listener won't receive any more callbacks (but can be re-used). Note that setting a profile will invalidate any currently active trip as the parameters for the trip change.

Parameters:

profile - The VehicleProfile to be set.

listener - The VehicleProfile.Listener to receive vehicle profile information.

Throws:

java.lang.IllegalArgumentException - if the listener is null.

Since:

4