Package com.navmii.sdk.routecalculation

Class RoutingManager

java.lang.Object

com.navmii.sdk.routecalculation.RoutingManager

public abstract class RoutingManager
extends java.lang.Object

Manager to be used to calculate or snap routes.

Constructor Summary

Constructors

Constructor	Description
RoutingManager()

Method Summary

Modifier and Type	Method	Description
abstract RouteCalculationSession	calculateRoute(java.util.ArrayList<RoutePlanPoint> routePlan, RouteCalculationOptions options, RouteCalculationListener statusReportListener)	Initiates route calculation process using the specified route plan.
abstract RouteCalculationSession	snapRoute(ExternalRoute route, SnappingOptions options, RouteCalculationListener statusReportListener)	Initiates route snapping process using the specified external route.
abstract RouteCalculationSession	snapRouteFromPosition(ExternalRoutePoint position, ExternalRoute route, SnappingOptions options, RouteCalculationListener statusReportListener)	Initiates route calculation process from the specified position to the start of the specified external route and then snapping performs snapping of the external route.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

RoutingManager

public RoutingManager()

Method Details

calculateRoute

public abstract RouteCalculationSession calculateRoute(java.util.ArrayList<RoutePlanPoint> routePlan, RouteCalculationOptions options, RouteCalculationListener statusReportListener)

Initiates route calculation process using the specified route plan. Default route calculation options are used. You must not release the returned session object until the route calculation has finished, otherwise route calculation will be canceled.

Parameters:

routePlan - List of waypoints to calculate a route via;

options - Options to be used during the route calculation process. Default options are used if 'null' is passed;

statusReportListener - Listener to get notifications on route calculation status updates.

Returns:

A route calculation session which is used to control the route calculation process.

snapRoute

public abstract RouteCalculationSession snapRoute(ExternalRoute route, SnappingOptions options, RouteCalculationListener statusReportListener)

Initiates route snapping process using the specified external route. You must not release the returned session object until the route snapping has finished, otherwise route snapping will be canceled.

Parameters:

route - External route to snap;

options - Options to be used during the route snapping process. Default options are used if 'null' is passed;

statusReportListener - Listener to get notifications on route snapping status updates.

Returns:

A route calculation session which is used to control the route snapping process.

snapRouteFromPosition

public abstract RouteCalculationSession snapRouteFromPosition(ExternalRoutePoint position, ExternalRoute route, SnappingOptions options, RouteCalculationListener statusReportListener)

Initiates route calculation process from the specified position to the start of the specified external route and then snapping performs snapping of the external route. You must not release the returned session object until the route snapping has finished, otherwise route snapping will be canceled.

Parameters:

position - The position from which a route will be calculated;

route - External route to snap;

options - Options to be used during the route snapping process. Default options are used if 'null' is passed;

statusReportListener - Listener to get notifications on route snapping status updates.

Returns:

A route calculation session which is used to control the route snapping process. Note: Please keep in mind that the start point of the route specified by the position parameter won't be added to the route plan as a waypoint required to visit. Once the route is sent to navigator, most likely the rerouting will take place and the calculated part of the route (from the specified position to the first point of the specified external route) will be recalculated from the current device position.