Route Matcher configuration

To configure the Route Matcher, you need to edit two specific sections in:

/opt/ptv-optima-vv.n.xxxxptv-optima-as/standalone/configuration/optima/optima-configuration.xml

This section is placed in the tag <configuration>/<optimaAuth>/<rate-limiting-per-optima-user>.

The WSI Route Matcher endpoints are protected by a rate limiting criterion:

<rate-limiting-per-optima-user>
                <route-matching>
                    <max-request>10000</max-request>
                    <period-second>60</period-second>
                </route-matching>
</rate-limiting-per-optima-user>

Parameter	Description
max-request	The maximum number of requests to the Route Matcher endpoints that are allowed in the configured period.
period-second	The configured time period in seconds for the Route Matcher endpoints rate limit.

Route matching section

This section is placed in the tag <configuration>/<routeMatching> and contains the configuration of the route-matching algorithm.

Parameter	Description
WEIGHT1	Weight to be assigned to the first function.
WEIGHT2	Weight to be assigned to the second function (not used in route-matching because the time is not available).
WEIGHT3	Weight to be assigned to the third function.
WEIGHT4	Weight to be assigned to the fourth function.
WEIGHT5	Weight to be assigned to the fifth function.
coordinatesAreInMetres	true if the points in the input have their coordinates given in meters.
allowAstarExploration	true if the A* exploration is permitted.
acceptDeniedTurn	true if the algorithm can build a path that includes a turn that is denied. Caution: If the database does not contain any information about denied turns, this parameter is considered to be TRUE, regardless of its configured value.
maxPathNum	Maximum number of paths from which the best path is chosen.
MAX_SEGMENT_DISTANCE	Maximum distance between two points beyond which the path breaks.
AstarMaxGoalNodes	Maximum number of nodes to associate with a GPS point. These nodes will be the goal nodes for the A* algorithm.
Astar_ACTIVATION_RATIO	Astar_ACTIVATION_RATIO × MAX_SEGMENT_DISTANCE is the threshold for the distance between two GPS points to activate the A* algorithm (when the value is higher than the threshold) rather than the recursive algorithm (when the value is lower than the threshold).
filterDistance FromGraph	Threshold to filter out raw data on distance from the graph: if the distance from a point to the graph is greater than filterDistanceFromGraph, such point is filtered out.
activationDistance ToProjection	Distance threshold: if the distance between a point and the projection computed by the recursive algorithm is greater than this value, the A* algorithm is applied, allowing you to reach the point which follows another given point.