ArcGIS Pro 3.4 API Reference Guide
ArcGIS.Core.Geometry Namespace / GeometryEngine Class / QueryPointAndDistance3D Method / QueryPointAndDistance3D(Segment,SegmentExtensionType,MapPoint,AsRatioOrLength,Double,Double) Method
The segment on which to find the closest point. The segment may be extended.
Describes if, how and where to extend segments.
The input point.
Determines whether the distanceAlongCurve is returned as a ratio of the curve length or as length from the start point.
Describes the distance from the start point of the segment to the input point, either as a ratio or length. If the input point is not on the segment, then the nearest location on the segment from the point is used.
Describes how far the point is from the curve.
Version

QueryPointAndDistance3D(Segment,SegmentExtensionType,MapPoint,AsRatioOrLength,Double,Double) Method
Finds the point on the curve closest to inPoint, then copies that point to outPoint. The operation is performed in 3D space. Also calculates related items.
Syntax

Parameters

segment
The segment on which to find the closest point. The segment may be extended.
extensionType
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 the distance from the start point of the segment to the input point, either as a ratio or length. If the input point is not on the segment, then the nearest location on the segment from the point is used.
distanceFromCurve
Describes how far the point is from the curve.

Return Value

MapPoint representing the closest point on the curve.
Exceptions
ExceptionDescription
Either segment or inPoint or both are null or empty.
segment is not Z-Aware.
Cannot do 3D operations on curve segments.
Spatial reference of segmentis an image coordinate system.
Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.
See Also