QueryPointAndDistance(Multipart,SegmentExtension,MapPoint,AsRatioOrLength,Double,Double,LeftOrRightSide) Method

Finds the point on the curve closest to inPoint, then copies that point to outPoint. Also calculates related items.

Syntax

C#
Visual Basic (Declaration)

MapPoint QueryPointAndDistance( 
   Multipart multipart,
   SegmentExtension extension,
   MapPoint inPoint,
   AsRatioOrLength asRatioOrLength,
   out double distanceAlongCurve,
   out double distanceFromCurve,
   out LeftOrRightSide whichSide
)

Overloads Function QueryPointAndDistance( _
   ByVal multipart As Multipart, _
   ByVal extension As SegmentExtension, _
   ByVal inPoint As MapPoint, _
   ByVal asRatioOrLength As AsRatioOrLength, _
   ByRef distanceAlongCurve As Double, _
   ByRef distanceFromCurve As Double, _
   ByRef whichSide As LeftOrRightSide _
) As MapPoint

Parameters

multipart: The curve on which to find the closest point. The curve may be extended.
extension: Describes if, how and where to extend segments.
inPoint: The input point.
asRatioOrLength: Determines whether the distanceAlongCurve is returned as a ratio of the curve length or as length from the start point.
distanceAlongCurve: Describes how far along the closest point is along the curve, either as a ratio or length.
distanceFromCurve: Describes how far the point is from the curve.
whichSide: Describes if the point is on the left or right side of the curve. The direction of the curve determines its left and right sides. If the point is on the curve, then LeftSide is returned.

Return Value

MapPoint representing the closest point on the curve.

Exceptions

Exception	Description
System.ArgumentNullException	Either multipart or inPoint or both are null or empty.

Example

// Horizontal line segment
List<MapPoint> linePts = new List<MapPoint>();
linePts.Add(MapPointBuilder.CreateMapPoint(1.0, 1.0, SpatialReferences.WGS84));
linePts.Add(MapPointBuilder.CreateMapPoint(11.0, 1.0, SpatialReferences.WGS84));
Polyline polyline = PolylineBuilder.CreatePolyline(linePts);
bool isSimple = GeometryEngine.Instance.IsSimpleAsFeature(polyline);

// Don't extent the segment
SegmentExtension extension = SegmentExtension.NoExtension;

// A point on the line segment
MapPoint inPoint = MapPointBuilder.CreateMapPoint(2, 1, SpatialReferences.WGS84);

double distanceAlongCurve, distanceFromCurve;
LeftOrRightSide whichSide;
AsRatioOrLength asRatioOrLength = AsRatioOrLength.AsLength;

MapPoint outPoint = GeometryEngine.Instance.QueryPointAndDistance(polyline, extension, inPoint, asRatioOrLength, out distanceAlongCurve, out distanceFromCurve, out whichSide);
// outPoint = 2, 1
// distanceAlongCurve = 1
// distanceFromCurve = 0
// whichSide = GeometryEngine.Instance.LeftOrRightSide.LeftSide


// Extend infinitely in both directions
extension = SegmentExtension.ExtendTangents;

// A point on the left side
inPoint = MapPointBuilder.CreateMapPoint(16, 6, SpatialReferences.WGS84);
asRatioOrLength = AsRatioOrLength.AsRatio;

outPoint = GeometryEngine.Instance.QueryPointAndDistance(polyline, extension, inPoint, asRatioOrLength, out distanceAlongCurve, out distanceFromCurve, out whichSide);
// outPoint = 16, 1
// distanceAlongCurve = 1.5
// distanceFromCurve = 5
// whichSide = GeometryEngine.Instance.LeftOrRightSide.LeftSide

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 7

Reference

IGeometryEngine Interface
IGeometryEngine Members
Overload List