This is an experimental API. It may be removed or changed from one version to the next.

A PathMatcher that filters observations, map matches the remaining observations using the inner PathMatcher, and interpolates a MatchResult for each observation previously filtered out. The Interpolator also adapts the MatchedPath#transitions accordingly.

Filtering is especially useful when the positions of observations are close to one another. This can happen when, for example, a car is slowly moving in a straight line, recording its position every second. Because of GPS noise, these observations can give the impression that the car was moving back and forth. Handling such a trip directly in a PathMatcher can be challenging. Instead, it is simpler to use a Filter in order to remove the observations that are responsible for this misleading impression.

Internally, PathMatcherWithFilter uses a Filter to mark each observation as either to be Omitted or to be Retained. It then collects the Retained observations and passes them to the inner PathMatcher for map matching. Last, it uses the Interpolator to process the resulting MatchedPath and create a new MatchedPath. This new MatchedPath contains an interpolated MatchResult for each observation previously filtered out and MatchedPath.transitions adapted to the new MatchedPath.results.