de.infoware.android.mti.NavigationListener Interface Reference

Public Member Functions
void	statusInfo (double latitude, double longitude, double metersToDestination, double remainingTimeInSeconds)
void	coiInfo (double latitude, double longitude, String currentStreetName, String nextStreetName, double meterToPoint)
void	crossingInfo (double latitude, double longitude, String currentStreetName, String nextStreetName, String nextManeuver, double meterToPoint)
void	destinationReached (int index)
void	insertDestinationCoordinateResult (int requestId, ApiError returnCode)
void	appendDestinationCoordinateResult (int requestId, int indexWhereAppended, ApiError returnCode)
void	insertDestinationAddressResult (int requestId, ApiError returnCode)
void	appendDestinationAddressResult (int requestId, int indexWhereAppended, ApiError returnCode)
void	insertGeocodedDestinationResult (int requestId, ApiError returnCode)
void	appendGeocodedDestinationResult (int requestId, int indexWhereAppended, ApiError returnCode)
void	markDestinationCoordinateAsViaPointResult (int requestId, ApiError returnCode)
void	getDestinationCoordinateResult (int requestId, ApiError returnCode, double latitude, double longitude)
void	getDestinationCoordinateCountResult (int requestId, ApiError returnCode, int count)
void	getCurrentDestinationResult (int requestId, ApiError returnCode, int index)
void	removeAllDestinationCoordinatesResult (int requestId, ApiError returnCode)
void	calculateRoutesResult (int requestId, ApiError returnCode)
void	startNavigationResult (int requestId, ApiError returnCode)
void	startAlternativeNavigationResult (int requestId, ApiError returnCode)
void	startTourResult (int requestId, ApiError returnCode)
void	skipNextDestinationResult (int requestId, ApiError returnCode)
void	startSimulationResult (int requestId, ApiError returnCode)
void	stopNavigationResult (int requestId, ApiError returnCode)
void	startRouteFromFileResult (int requestId, ApiError returnCode)
void	startReferenceRouteResult (int requestId, ApiError returnCode)
void	getReferenceRouteFileResult (int requestId, String routeFile, ApiError returnCode)
void	syncWithActiveNavigationResult (int requestId, ApiError returnCode)
void	navigateWithGuiGeocodingResult (int requestId, ApiError returnCode)
void	routingStarted ()
void	routeCalculated ()
void	setRoutingModeHybridResult (int requestId, ApiError returnCode)
void	newRouteAvailable ()
void	setEmergencyRoutingEnabledResult (int requestId, ApiError returnCode)
void	getEmergencyRoutingEnabledResult (int requestId, ApiError returnCode, boolean isEnabled, boolean isActive, int RadiusMtrs)
void	setEmergencyRouteRadiusResult (int requestId, ApiError returnCode)
void	getEmergencyRouteRadiusResult (int requestId, ApiError returnCode, int radius)
void	setAsReferenceRouteResult (int requestId, ApiError returnCode)

Member Function Documentation

appendDestinationAddressResult()

void de.infoware.android.mti.NavigationListener.appendDestinationAddressResult	(	int	requestId,
		int	indexWhereAppended,
		ApiError	returnCode
	)

Called after adding an address Navigation.appendDestinationAddress().

Parameters

requestId	- unique identifier returned by the initiating request
indexWhereAppended	- 0 based index in the destination coordinate list where the coordinate has been appended
returnCode	- ApiError.OK if successful ApiError.INVALID_INDEX if index is > that the number of elements + 1 ApiError.NAVIGATION_RUNNING if a navigation is running.

appendDestinationCoordinateResult()

void de.infoware.android.mti.NavigationListener.appendDestinationCoordinateResult	(	int	requestId,
		int	indexWhereAppended,
		ApiError	returnCode
	)

Called after appending an address Navigation.appendDestinationCoordinate().

Parameters

requestId	- unique identifier returned by the initiating request
indexWhereAppended	- 0 based index in the destination coordinate list where the coordinate has been appended
returnCode	- ApiError.OK if successful ApiError.INVALID_INDEX if index is > that the number of elements + 1 ApiError.NAVIGATION_RUNNING if a navigation is running.

appendGeocodedDestinationResult()

void de.infoware.android.mti.NavigationListener.appendGeocodedDestinationResult	(	int	requestId,
		int	indexWhereAppended,
		ApiError	returnCode
	)

Called after adding an address Navigation.appendGeocodedDestination().

Parameters

indexWhereAppended	- 0 based index in the destination coordinate list where the coordinate has been appended
requestId	- unique identifier returned by the initiating request
returnCode	- ApiError.OK if successful WRONG_PARAM if the geocoded address index is > than the available of geocoder results from the last call of Geocoder.geocodeAddress() ApiError.NAVIGATION_RUNNING if a navigation is running.

calculateRoutesResult()

void de.infoware.android.mti.NavigationListener.calculateRoutesResult	(	int	requestId,
		ApiError	returnCode
	)

Called after processing an Navigation.calculateRoutes() call.

Parameters

requestId

- unique identifier returned by the initiating request

returnCode

- ApiError.OK if successful ApiError.NO_DESTINATION if no coordinates were added to the destination list ApiError.NAVIGATION_RUNNING if a navigation is already running, call Navigation.stopNavigation() ApiError.ROUTING if f.e. the coordinates in the destination list are not valid in the map data ApiError.OPERATION_CANCELED if user aborted route calculation ApiError.ROUTING_MEMORY_ALLOCATION if memory is too low for the route calculation

coiInfo()

void de.infoware.android.mti.NavigationListener.coiInfo	(	double	latitude,
		double	longitude,
		String	currentStreetName,
		String	nextStreetName,
		double	meterToPoint
	)

This callback is used to send status information about crossings during a navigation.

Parameters

latitude	- WGS84
longitude	- WGS84
currentStreetName	- name of the current street
meterToPoint	- distance to crossing in meters; -1 if no navigation is started
nextStreetName	- name of the next street; empty if no navigation is started

crossingInfo()

void de.infoware.android.mti.NavigationListener.crossingInfo	(	double	latitude,
		double	longitude,
		String	currentStreetName,
		String	nextStreetName,
		String	nextManeuver,
		double	meterToPoint
	)

This callback is used to send more detailed status information about the next relevant crossing during a navigation.

The nextManeuver can have the following values:

• "Highway"
• "LeaveL"
• "LeaveR"
• "ReachedDestination"
• "RoundABout_dg0"
• "RoundABout_dg45"
• "RoundABout_dg90"
• "RoundABout_dg135"
• "RoundABout_dg225"
• "RoundABout_dg270"
• "RoundABout_dg315"
• "StayL"
• "StayR"
• "Straight"
• "TakeTheFerry"
• "TurnL"
• "TurnLSharp"
• "TurnLSoft"
• "TurnR"
• "TurnRSharp"
• "TurnRSoft"
• "UTurn"

Parameters

latitude	- WGS84
longitude	- WGS84
currentStreetName	- name of the current street
meterToPoint	- distance to crossing in meters; -1 if no navigation is started
nextStreetName	- name of the next street; empty if no navigation is started
nextManeuver	- Text description of the action to take at the next crossing (e.g. Turn left = "TurnL")

destinationReached()

void de.infoware.android.mti.NavigationListener.destinationReached

(

int

index

)

This callback is used to send information if a destination in the navigation goal list was reached.

Parameters

index

- index of the destination in the destination list that has been reached

getCurrentDestinationResult()

void de.infoware.android.mti.NavigationListener.getCurrentDestinationResult	(	int	requestId,
		ApiError	returnCode,
		int	index
	)

Called after processing an Navigation.getCurrentDestination() call. The returned index can be used the request the coordinate and address of the current destination via Navigation.getDestinationCoordinate().

Parameters

requestId	- unique identifier returned by the initiating request
index	- index of the current destination in the destination list
returnCode	- ApiError.OK if successful

getDestinationCoordinateCountResult()

void de.infoware.android.mti.NavigationListener.getDestinationCoordinateCountResult	(	int	requestId,
		ApiError	returnCode,
		int	count
	)

Called after adding an address Navigation.getDestinationCoordinateCount().

Parameters

requestId	- unique identifier returned by the initiating request
count	- number of destination coordinates already added to the destination list
returnCode	- ApiError.OK if successful

getDestinationCoordinateResult()

void de.infoware.android.mti.NavigationListener.getDestinationCoordinateResult	(	int	requestId,
		ApiError	returnCode,
		double	latitude,
		double	longitude
	)

Called after adding an address Navigation.getDestinationCoordinate().

Parameters

requestId	- unique identifier returned by the initiating request
latitude	- WGS84 coordinate of the navigation goal, 0.0 if the index was invalid
longitude	- WGS84 coordinate of the navigation goal, 0.0 if the index was invalid
returnCode	- ApiError.OK if successful ApiError.INVALID_INDEX if index is > that the number of elements

getEmergencyRouteRadiusResult()

void de.infoware.android.mti.NavigationListener.getEmergencyRouteRadiusResult	(	int	requestId,
		ApiError	returnCode,
		int	radius
	)

Called after a call to mti_nav_getEmergencyRouteRadius is completed

Parameters

requestId	- unique identifier returned by the initiating request
returnCode	- ApiError.OK if successful
radius	- radius in meters around the destinations where emergency routing will be active

getEmergencyRoutingEnabledResult()

void de.infoware.android.mti.NavigationListener.getEmergencyRoutingEnabledResult	(	int	requestId,
		ApiError	returnCode,
		boolean	isEnabled,
		boolean	isActive,
		int	RadiusMtrs
	)

Called after a call to mti_nav_getEmergencyRoutingEnabled is completed

Parameters

requestId	- unique identifier returned by the initiating request
returnCode	- ApiError.OK if successful
isEnabled	- true if emergency routing is enabled - this can be set by calling mti_nav_setEnableEmergencyRouting
isActive	- true if the current navigation is now in emergency mode as the position is within the specified radius to the destination
RadiusMtrs	- radius in meters around the destinations where emergency routing will be active

getReferenceRouteFileResult()

void de.infoware.android.mti.NavigationListener.getReferenceRouteFileResult	(	int	requestId,
		String	routeFile,
		ApiError	returnCode
	)

Called after processing an Navigation.startReferenceRoute() call.

Parameters

requestId	- unique identifier returned by the initiating request
returnCode	- ApiError.OK if successful ApiError.NOT_STARTED if no reference route navigation running

insertDestinationAddressResult()

void de.infoware.android.mti.NavigationListener.insertDestinationAddressResult	(	int	requestId,
		ApiError	returnCode
	)

Called after adding an address Navigation.insertDestinationAddress().

Parameters

requestId	- unique identifier returned by the initiating request
returnCode	- ApiError.OK if successful ApiError.INVALID_INDEX if index is > that the number of elements + 1 ApiError.NAVIGATION_RUNNING if a navigation is running.

insertDestinationCoordinateResult()

void de.infoware.android.mti.NavigationListener.insertDestinationCoordinateResult	(	int	requestId,
		ApiError	returnCode
	)

Called after adding an address Navigation.insertDestinationCoordinate().

Parameters

requestId	- unique identifier returned by the initiating request
returnCode	- ApiError.OK if successful ApiError.INVALID_INDEX if index is > that the number of elements + 1 ApiError.NAVIGATION_RUNNING if a navigation is running.

insertGeocodedDestinationResult()

void de.infoware.android.mti.NavigationListener.insertGeocodedDestinationResult	(	int	requestId,
		ApiError	returnCode
	)

Called after adding an address Navigation.insertGeocodedDestination().

Parameters

requestId	- unique identifier returned by the initiating request
returnCode	- ApiError.OK if successful ApiError.INVALID_INDEX if index is > that the number of elements + 1 WRONG_PARAM if the geocoded address index is > than the available of geocoder results from the last call of Geocoder.geocodeAddress() ApiError.NAVIGATION_RUNNING if a navigation is running.

markDestinationCoordinateAsViaPointResult()

void de.infoware.android.mti.NavigationListener.markDestinationCoordinateAsViaPointResult	(	int	requestId,
		ApiError	returnCode
	)

Called after setting a navigation goal as via point with Navigation.markDestinationCoordinateAsViaPoint() .

Parameters

requestId	- unique identifier returned by the initiating request
returnCode	- ApiError.OK if successful ApiError.INVALID_INDEX if index is > that the number of elements ApiError.NAVIGATION_RUNNING if a navigation is running.

navigateWithGuiGeocodingResult()

void de.infoware.android.mti.NavigationListener.navigateWithGuiGeocodingResult	(	int	requestId,
		ApiError	returnCode
	)

Called after processing an Navigation.navigateWithGuiGeocoding() call.

Parameters

requestId	- unique identifier returned by the initiating request
returnCode	- ApiError.OK if successful

newRouteAvailable()

void de.infoware.android.mti.NavigationListener.newRouteAvailable

(

)

Called when a new offboard route is available from the server

Parameters

requestId	- unique identifier returned by the initiating request
returnCode	- ApiError.OK if successful

removeAllDestinationCoordinatesResult()

void de.infoware.android.mti.NavigationListener.removeAllDestinationCoordinatesResult	(	int	requestId,
		ApiError	returnCode
	)

Called after processing an Navigation.removeAllDestinationCoordinates() call.

Parameters

requestId	- unique identifier returned by the initiating request
returnCode	- ApiError.OK if successful ApiError.NAVIGATION_RUNNING if a navigation is already running, call Navigation.stopNavigation()

routeCalculated()

void de.infoware.android.mti.NavigationListener.routeCalculated

(

)

Called when a routing process is finished.

routingStarted()

void de.infoware.android.mti.NavigationListener.routingStarted

(

)

Called when a routing process is initiated.

setAsReferenceRouteResult()

void de.infoware.android.mti.NavigationListener.setAsReferenceRouteResult	(	int	requestId,
		ApiError	returnCode
	)

Called after a call to mti_nav_setAsReferenceRoute is completed

Parameters

requestId	- unique identifier returned by the initiating request
returnCode	- ApiError.OK if successful

setEmergencyRouteRadiusResult()

void de.infoware.android.mti.NavigationListener.setEmergencyRouteRadiusResult	(	int	requestId,
		ApiError	returnCode
	)

Called after a call to mti_nav_setEmergencyRouteRadius is completed

Parameters

requestId	- unique identifier returned by the initiating request
returnCode	- ApiError.OK if successful

setEmergencyRoutingEnabledResult()

void de.infoware.android.mti.NavigationListener.setEmergencyRoutingEnabledResult	(	int	requestId,
		ApiError	returnCode
	)

Called after a call to mti_nav_setEmergencyRoutingEnabled is completed

Parameters

requestId	- unique identifier returned by the initiating request
returnCode	- ApiError.OK if successful

setRoutingModeHybridResult()

void de.infoware.android.mti.NavigationListener.setRoutingModeHybridResult	(	int	requestId,
		ApiError	returnCode
	)

Called when a new offboard route is available from the server

skipNextDestinationResult()

void de.infoware.android.mti.NavigationListener.skipNextDestinationResult	(	int	requestId,
		ApiError	returnCode
	)

Called after processing an Navigation.skipNextDestination() call.

Parameters

requestId	- unique identifier returned by the initiating request
returnCode	- ApiError.OK if successful ApiError.NO_DESTINATION if no more destinations are in the destination list ApiError.NO_ROUTE if there is no route

startAlternativeNavigationResult()

void de.infoware.android.mti.NavigationListener.startAlternativeNavigationResult	(	int	requestId,
		ApiError	returnCode
	)

Called after processing an Navigation.startAlternativeNavigation() call.

Parameters

requestId

- unique identifier returned by the initiating request

returnCode

- ApiError.OK if successful ApiError.NO_DESTINATION if no coordinates were added to the destination list ApiError.NAVIGATION_RUNNING if a navigation is already running, call Navigation.stopNavigation() ApiError.ROUTING if f.e. the coordinates in the destination list are not valid in the map data ApiError.OPERATION_CANCELED if user aborted route calculation ApiError.ROUTING_MEMORY_ALLOCATION if memory is too low for the route calculation

startNavigationResult()

void de.infoware.android.mti.NavigationListener.startNavigationResult	(	int	requestId,
		ApiError	returnCode
	)

Called after processing an Navigation.startNavigation() call.

Parameters

requestId

- unique identifier returned by the initiating request

returnCode

- ApiError.OK if successful ApiError.NO_DESTINATION if no coordinates were added to the destination list ApiError.NAVIGATION_RUNNING if a navigation is already running, call Navigation.stopNavigation() ApiError.ROUTING if f.e. the coordinates in the destination list are not valid in the map data ApiError.OPERATION_CANCELED if user aborted route calculation ApiError.ROUTING_MEMORY_ALLOCATION if memory is too low for the route calculation

startReferenceRouteResult()

void de.infoware.android.mti.NavigationListener.startReferenceRouteResult	(	int	requestId,
		ApiError	returnCode
	)

Called after processing an Navigation.startReferenceRoute() call.

Parameters

requestId

- unique identifier returned by the initiating request

returnCode

- ApiError.OK if successful ApiError.NO_DESTINATION if less than two coordinates were added to the destination list ApiError.NAVIGATION_RUNNING if a navigation is already running, call Navigation.stopNavigation() ApiError.ROUTING if f.e. the coordinates in the destination list are not valid in the map data ApiError.OPERATION_CANCELED if user aborted route calculation ApiError.ROUTING_MEMORY_ALLOCATION if memory is too low for the route calculation

startRouteFromFileResult()

void de.infoware.android.mti.NavigationListener.startRouteFromFileResult	(	int	requestId,
		ApiError	returnCode
	)

Called after processing an Navigation.startRouteFromFile() call.

Parameters

requestId

- unique identifier returned by the initiating request

returnCode

- ApiError.OK if successful ApiError.WRONG_PARAM if passed file is in the wrong format (No MapTrip XML or OLR) ApiError.NO_DESTINATION if less than one coordinate is in the destination list or the file is semantically not correct ApiError.NAVIGATION_RUNNING if a navigation is already running, call Navigation.stopNavigation() ApiError.ROUTING if f.e. the coordinates in the destination list are not valid in the map data or the file does not contain a valid destnation list ApiError.OPERATION_CANCELED if user aborted route calculation ApiError.ROUTING_MEMORY_ALLOCATION if memory is too low for the route calculation

startSimulationResult()

void de.infoware.android.mti.NavigationListener.startSimulationResult	(	int	requestId,
		ApiError	returnCode
	)

Called after processing an Navigation.startSimulation() call.

Parameters

requestId

- unique identifier returned by the initiating request

returnCode

- ApiError.OK if successful ApiError.NO_DESTINATION if less than two coordinates were added to the destination list ApiError.NAVIGATION_RUNNING if a navigation is already running, call Navigation.stopNavigation() ApiError.ROUTING if f.e. the coordinates in the destination list are not valid in the map data ApiError.OPERATION_CANCELED if user aborted route calculation ApiError.ROUTING_MEMORY_ALLOCATION if memory is too low for the route calculation

startTourResult()

void de.infoware.android.mti.NavigationListener.startTourResult	(	int	requestId,
		ApiError	returnCode
	)

Called after processing an Navigation.startTour() call.

Parameters

requestId

- unique identifier returned by the initiating request

returnCode

- ApiError.WAITING_FOR_UI if successful ApiError.NO_DESTINATION if no coordinates were added to the destination list ApiError.NAVIGATION_RUNNING if a navigation is already running, call Navigation.stopNavigation() ApiError.ROUTING if f.e. the coordinates in the destination list are not valid in the map data ApiError.OPERATION_CANCELED if user aborted route calculation ApiError.ROUTING_MEMORY_ALLOCATION if memory is too low for the route calculation

statusInfo()

void de.infoware.android.mti.NavigationListener.statusInfo	(	double	latitude,
		double	longitude,
		double	metersToDestination,
		double	remainingTimeInSeconds
	)

This callback is used to send status information during a navigation. It is only called if a navigation is running.

Parameters

latitude	- WGS84
longitude	- WGS84
metersToDestination	- distance to destination in meters
remainingTimeInSeconds	- estimated duration till destination is reached

stopNavigationResult()

void de.infoware.android.mti.NavigationListener.stopNavigationResult	(	int	requestId,
		ApiError	returnCode
	)

Called after processing an Navigation.stopNavigation() call.

Parameters

requestId	- unique identifier returned by the initiating request, MTI_REQUEST_NO_REQUEST_ID if not initiated by an MTI request (via GUI)
returnCode	- ApiError.OK if successful

syncWithActiveNavigationResult()

void de.infoware.android.mti.NavigationListener.syncWithActiveNavigationResult	(	int	requestId,
		ApiError	returnCode
	)

Called after processing an Navigation.syncWithActiveNavigation() call.

Parameters

requestId	- unique identifier returned by the initiating request
returnCode	- ApiError.OK if successful ApiError.NOT_STARTED if no navigation running