S2MinDistanceShapeIndexTarget

An S2DistanceTarget subtype for computing the minimum distance to an S2ShapeIndex \(a collection of points, polylines, and/or polygons\).

Note that ShapeIndexTarget has its own options:

include_interiors() - specifies that distances are measured to the boundary and interior of polygons in the S2ShapeIndex. \(If set to false, distance is measured to the polygon boundary only.\) DEFAULT: true.

brute_force() - specifies that the distances should be computed by examining every edge in the S2ShapeIndex \(for testing and debugging purposes\). DEFAULT: false.

These options are specified independently of the corresponding S2ClosestEdgeQuery options. For example, if include_interiors is true for an ShapeIndexTarget but false for the S2ClosestEdgeQuery where the target is used, then distances will be measured from the boundary of one S2ShapeIndex to the boundary and interior of the other.

Note that when the distance to a ShapeIndexTarget is zero because the target intersects the interior of the query index, you can find a point that achieves this zero distance by calling the visitContainingShapes() method directly. For example:

auto target = new S2ClosestEdgeQuery.ShapeIndexTarget(target_index);
target.visitContainingShapes(
    query_index, (S2Shape containing_shape, const S2Point& target_point) {
      ... do something with "target_point" ...
      return false;  // Terminate search
    });