Configuration Parameters

_|

Configuration Parameters class in Fleet Management SDK define key settings that influence the behavior of the route optimization process. These settings determine aspects such as optimization goals, search time limits, and flexibility in handling orders. Proper configuration ensures that the algorithm meets the operational constraints of the routing problem.

Configuration Parameters Structure

Each Configuration Parameter consists of:

Name	Type	Description
Name	String	The name of the optimization/route configuration.
IgnoreTimeWindow	bool	Specifies whether time-windows are ignored during optimization. Default is false.
AllowDroppingOrders	bool	Specifies whether the algorithm is allowed to drop orders if no solution is found by visiting all of them. Default is false.
GroupingOrders	bool	Specify if the orders will be grouped. If the distance between any two orders is less than 10 meters, those orders will be considered part of the same group. Default is false.
BalancedRoutes	EBalanceRoutesOption	Specifies the option to balance routes of an optimization. Possible values: • EB_None (0): No balancing. • EB_ByTime (1): Balance by time. • EB_ByNumberOfOrders (2): Balance by the number of orders.
OptimizationCriterion	EOptimizationCriterion	Specifies the optimization criterion. Possible values: • OC_Time (0): The problem will be optimized by distance. (the route with the shortest distance). • OC_Distance (1): The problem will be optimized by time. (the route with the shortest time).
ArrangeCriterion	EArrangeCriterion	Specifies the arrangement criterion for optimizing time. Used only if OptimizationCriterion = Distance. • AC_Matrix (0): The orders are arranged based on the matrix distance. • AC_Euclidian (1): The distance between 2 orders is calculated with Euclidean distance formula(in straight line) and the result is rounded. • AC_ExactEuclidian (2): The distance between 2 orders is calculated with Euclidean distance formula(in straight line) and the result is decimal. • AC_Geodesic (3): The distance between 2 orders is calculated in straight line taking into consideration the curve of the Earth. • AC_Manhattan (4): The distance between 2 orders is calculated with the Manhattan distance formula.
OptimizationQuality	EOptimizationQuality	Specifies the optimization quality (solution accuracy). Possible values: • OQ_Unoptimized (0): The algorithm will return an unoptimized solution. • OQ_Fast (1): The algorithm will return the first solution found. (Not an accurate solution) • OQ_Optimized (2): The algorithm will return an optimized solution. • OQ_Best (3): The algorithm will return the best solution found in the specified time.
MaxSearchTime	unsigned int	Maximum time (in seconds) the algorithm can search for a solution. This parameter is considered only when the Optimization Quality is set to OQ_Best. Default is 300 seconds.
MaxWaitTime	unsigned int	Maximum time (in seconds) that vehicles can wait at an order to align with the next order's time window. Default is INT_MAX.
RouteType	ERouteType	Specifies the route type. Possible values: • RT_RoundRoute (0): The route will return at the first order (circuit). • RT_EndAnywhere (1): The route will end at the most efficient order selected by the algorithm. • RT_CustomEnd (2): The route will end at the specified order.
Restrictions	ERoadRestrictions	Specifies road restrictions for distance and time matrix calculations. Possible values: • RR_None (0): No restrictions. • RR_Tolls (1): Avoid toll road restriction. • RR_Highways (2): Avoid highways restriction.
DistanceUnit	EDistanceUnit	Specifies the unit of distance used in optimization and routing calculations. Possible values: • DU_Kilometers (0): Distance in kilometers. • DU_Miles(1): Distance in miles.
OrderSequenceOptions	OrdersSequenceMap	Specifies the association between different orders that should be visited in a certain order. Format: A map where each pair contains an enum and a list of lists, where each inner list is a sequence of order IDs.

Example Usage

ConfigurationParameters config;  
config.setName("Test Optimization");  
config.setIgnoreTimeWindow(false);  
config.setAllowDroppingOrders(true);  
config.setMaxSearchTime(600);  
config.setRouteType(ERouteType::RT_RoundRoute);  
config.setOptimizationCriterion(EOptimizationCriterion::OC_Distance);  

Explanation

This setup configures an optimization with the following characteristics:

• "Test Optimization" as the instance name – Helps in identifying the optimization session.
• Time windows are considered (IgnoreTimeWindow = false) – Ensures delivery times are respected.
• Orders can be dropped if necessary (AllowDroppingOrders = true) – If an order is impossible to fulfill, it can be left out.
• Algorithm runs for a maximum of 600 seconds (MaxSearchTime = 600) – Limits the computation time.
• Minimization of travel distance as the primary goal (OptimizationCriterion = OC_Distance) – The algorithm will prioritize shorter routes.
• Every route of the optimization will be circular (RouteType = RT_RoundRoute) - The routes will start and end at the same location.