Defines parameters to configure the crawling algorithm.

Defines parameters of the weights to find candidate locations based on the raw location and the possible route. The sum of all ratings divided by the sum of all weights will result in a value between 0.0 and 1.0 which is named "local rating".

            The (effective) heading difference weight can be calculated dynamically for each position with respect to its speed. During slow movement, the given heading from a GPS signal
            may deviate strongly from the actual heading, so if the input position provides a low speed, the influence of the heading difference in the final rating can be reduced.
            Therefore a normal velocity can be provided as a "reference" speed for which the effective weight is to equal the normal heading difference weight. If the speed decreses,
            the effective weight decreases as well, and if the speed increases, the effective weight increases, too. To avoid too extreme variations in the weight, the range is bounded by
            configurable minimum and maximum values.

            All other weights are fixed to a single value, that can be configured directly.

This element specified parameters for the dynamic calculation of the heading difference weight.

History consideration is used to trace back a possible driven route based on the specified TrackPositions. Consecutive candidates of a list of possible pathes will be stored in the history. For a new possible candidate all pathes will be considered. This is called global matching. When this feature is turned off, all trackPositions are matched local only, meaning that the mapmatcher will not try to reconstruct a driven route but only matches each position to the map by itself.

The best path should be signaled on a history loss or at the end of a track if it is good enough.

Defines geometric devitations between the specified TrackPositions and a potential candidate.

Please note that the parameter will be only used for enabled history consideration (global matching).
                  
                  If no history is present (history lost), the next position is matched locally with the usual (un-extended) linking radius.
                  If this match is successful, the linking radius is extended (with an initial value) and the local matching is repeated with the new radius.

                  For the next positions, with each position the linking radius extension is decreased by the respective
                  distance estimations until it reaches 0. While the linking radius is extended, there is no reduction of
                  paths based on the rating, and no minimal distance between candidates.

                  Using the linking radius extension, further segments can be found during the local matching,
                  which increases the chance to find the correct one, especially after driving off-road
                  (e.g. on private ground, or outside of the map data area).

Defines the parameter that control whether the route restrictions could be broken (violated).

Defines Mapmatching parameters.

The factor which is specified by this option is used to calculate the range in which the crawling algorithm operates. The crawling is done in a certain range which is calculated by multiplying 'movingDistanceRangeFactor' with the moving distance and substracting it from the moving distance to determine the lower range bound, and adding it to the moving distance to determine the upper range bound.

If the calculated lower crawling range bounds (in meters) as described in 'movingDistanceRangeFactor' is smaller than the 'movingDistanceRangeMinimum' as specified by this option, this 'movingDistanceRangeMinimum' is used instead. Distance in meters.

If the calculated upper crawling range bounds (in meters) as described in 'movingDistanceRangeFactor' is larger than the 'movingDistanceRangeMaximum' as specified by this option, this 'movingDistanceRangeMaximum' is used instead.

This option specifies the maximum number of passed junctions during the crawling process. Only paths which passed less junctions than this are considered during crawling.

It can be specified if junctions in tunnels will be also counted or not. Setting the parameter to true can be helpful to avoid long running requests if the parameter 'maximumCrawlingLoopCount' is not strong enough.

This option specifies the maximum number of passed loops during the crawling process. Only paths which passed less loops than this are considered during crawling.

The loop limitation can be switched only for tunnel segments or for all net segments.

Enlarge the search range. Enables special handling for turn detection. If the vehicle is turning the maximum crawling range is prolonged, meaning that additional candidates will be created even if the normal maximum crawling range is exceeded.

U-turns are allowed when the vehicle is turning. All streets around the vehicle will be considered in the crawling algorithm. As well the streets which lay behind the vehicle and were probably passed by it before. As well the streets which have not the same direction as the considered heading of the vehicle.

The A* algorithm is used to improve the runtime. All paths are skipped, if they can no more lead to valid candidates because of the airline distance to the link radius around the destination.

The factor which is specified by this option is used to weak the A* calculation.

This option specifies the velocity in meters per second which is used as base velocity to compute the ratio to the actual velocity in a position. The normal velocity is the velocity for which the effective heading difference weight equals the normal heading difference weight. If the velocity is lower (or higher), the effective weight will be lower (or higher, respectively) as well, bounded by a configurable minimum and maximum value.

The linking distance, meaning the distance between a candidate location and the raw location, is rated for each candidate using the rating function as described in interpolation points for distance rating.

The heading difference, meaning the difference between the candidate's heading and the current raw location's heading in degrees, is rated for each candidate using the rating function as described in Interpolation points for angle rating.
Must not be set if headingDifferenceRatingMinimum, headingDifferenceRatingNormal, headingDifferenceRatingMaximum or HeadingDifferenceRatingParameters/normalVelocity are set.

The heading difference, meaning the difference between the candidate's heading and the current raw location's heading in degrees, is rated for each candidate using the rating function as described in Interpolation points for angle rating.

                This attribute specifies the minimal weight of the heading difference for the local rating of a matched location. It is the lower bound for the effective heading difference weight (recalculated for each position a formula depending on speed) which considers the heading tolerance of a candidate. The calculated heading difference weight never falls below the value of this minimal heading difference weight.

The heading difference, meaning the difference between the candidate's heading and the current raw location's heading in degrees, is rated for each candidate using the rating function as described in Interpolation points for angle rating.

                This option specifies the normal weight of the heading difference for the local rating of a matched location. It is part of the formula to calculate the effective heading difference weight (recalculated for each position) which considers the heading tolerance of a candidate. The effective heading difference weight can't be greater than the maximal heading difference weight and can't be less than the minimal heading difference weight.

                If the driven velocity is equal to the normal velocity, the heading difference weigth is equal to the normal heading difference weight.

The heading difference, meaning the difference between the candidate's heading and the current raw location's heading in degrees, is rated for each candidate using the rating function as described in Interpolation points for angle rating.

                This attribute specifies the maximal weight of the heading difference for the local rating of a matched location. It is the upper bound for the effective heading difference weight (recalculated for each position by a formula depending on speed) which considers the heading tolerance of a candidate. The calculated heading difference weight never exceeds the value of this maximal heading difference weight.

The transition rating, meaning a quality rating of the driven distance of a candidate relative to the driven distance given by the raw location, is calculated for each candidate using the rating function as described in Interpolation points for transition rating.

The raw location quality of all candidates in a history element is considered for the calculation of the local rating. The raw location quality, which ranges from 0.0 to 1.0, may for example be the quality of a GPS position. The GPS position's quality is bad if there were fewer satellites available for positioning and is good if there are many satellites available. Other location providers may always have a position quality of 1.0.

In some cases a reduced heading difference weighting is used for the angle rating of the local rating.

Determines whether the best path should be signaled on a history loss or at the end of a track if it is good enough.

The minimal ratio between the two best paths, to determine whether the best is sufficiently better than the alternatives.
To get the best path the ratio has to be better (greater) or equal than this minimal ratio. To get always the best path the minimal ratio has to be 1.0.

History consideration is used to trace back a possible driven route based on the specified TrackPositions. Consecutive candidates of a list of possible pathes will be stored in the history. For a new possible candidate all pathes will be considered. This is called global matching. When this feature is turned off, all trackPositions are matched local only, meaning that the mapmatcher will not try to reconstruct a driven route but only matches each position to the map by itself.

The maximum number of attempts to redo a history matching if previous history matchings failed.
If no succesful global matching can be done, the mapmatcher will at this position start over again with a clean history. Usually this leaves a gap in the matched track.

The maximum number of elements in the history. They will be used for the calculation of the positions. The higher the value the higher the need of memory. Note that the minimum value for this setting is 3!

Each potential candidate during map matching is rated. Only the best potential candidates are kept and made to real candidates while the rest of them are discarded. This option specifies many of the best-rated candidates are kept.

A number of consecutive candidates on one possible path are stored in the history. This value limits the number of candidates with a bad quality. The size of the history increases by this value.

Enables the possibility to save all predecessor matched locations if they are merged into the successors. This functionality only applies, if the limit of the history elements is reached. No matched location will be removed of the history.

Determines whether the linking radius is extended after history lost.

The initial linking radius extension in meters, which is used to extend the linking radius after the first local matching was successful.

The maximum distance in meters between the specified TrackPosition and a potential candidate. The position of the potential candidate is the linked position to a segment of the map.

The maximum angle difference in degrees of the heading between the specified TrackPosition and a potential candidate.

The speed up to which a vehicle is considered to be standing still in meters per second (m/s). If the speed is below this threshold the vehicle is considered to be standing still. If the speed is above this threshold, it is considered to be moving.

Each potential candidate during map matching is rated which results in the path rating. The path rating specifies the rating of the path that starts at the last stable position and ends at the current candidate. The quotient specified by this option is the maximum accepted quotient between the best candidate's path rating and another candidate's path rating. If the quotient is above 'maximumPathRatingQuotient', the potential candidate is discarded.

The consideration of blocking information. Blocking information is used during map matching for blocked streets/roads and for one-way streets. Only those roads which are allowed to be driven on in the respective direction are considered.

The consideration of turning bans.

The major version of the Mapmatching element.

The minor version of the Mapmatching element.

For each candidate of an element a probability is calculated using the local rating of this candidate. Local rating is if the probability of one point will be considered allone without other points. Only if the probability of a candidate is above a certain threshold this candidate is signaled. The best candidate (the candidate with the best local rating) also receives a bonus to its local rating before said calculation is done. This option specifies the bonus which is added to the best candidate's local rating.

For each candidate of an element a probability is calculated using the local rating of this candidate. Only if the probability of a candidate is above a certain threshold this candidate is signaled.