ConstructGeodeticLineFromPoints Method (GeometryEngine)

In This Topic

Constructs a geodetic line connecting the specified points.

Syntax

C#
Visual Basic (Declaration)

public Polyline ConstructGeodeticLineFromPoints( 
   GeodeticCurveType curveType,
   MapPoint fromPoint,
   MapPoint toPoint,
   LinearUnit linearUnit,
   CurveDensifyMethod densifyMode,
   double densifyParameter
)

Public Function ConstructGeodeticLineFromPoints( _
   ByVal curveType As GeodeticCurveType, _
   ByVal fromPoint As MapPoint, _
   ByVal toPoint As MapPoint, _
   ByVal linearUnit As LinearUnit, _
   ByVal densifyMode As CurveDensifyMethod, _
   ByVal densifyParameter As Double _
) As Polyline

Parameters

curveType: The type of geodetic curve to be created.
fromPoint: The from point.
toPoint: The to point.
linearUnit: The linear unit of the densifyParameter if the densifyMode is DensifyByLength. If this is null, the units are assumed to be meters.
densifyMode: The densification mode.
densifyParameter: The densification parameter.

Return Value

Returns the created geodetic line.

Exceptions

Exception	Description
System.ArgumentNullException	Either fromPoint or toPoint is null.
System.ArgumentException	Either fromPoint or toPoint is empty.
System.ArgumentException	densifyParameter cannot be NaN.
System.ArgumentException	CurveDensifyMethod.ByAngle is not supported.

Remarks

If the densifyMode is DensifyByLength, then the densifyParameter specifies the maximum segment length.

If the densifyMode is DensifyByDeviation, then it is the maximum distance from the true geodetic line to the densified output.

Example

Construct a geodetic line connecting points

var sr = SpatialReferenceBuilder.CreateSpatialReference(4326);

var pt1 = MapPointBuilderEx.CreateMapPoint(60, 180, sr);
var pt2 = MapPointBuilderEx.CreateMapPoint(60, 0, sr);

// densify by length
var gl = GeometryEngine.Instance.ConstructGeodeticLineFromPoints(GeodeticCurveType.Geodesic, pt1, pt2, null, CurveDensifyMethod.ByLength, -3.356);

// densify by deviation
gl = GeometryEngine.Instance.ConstructGeodeticLineFromPoints(GeodeticCurveType.Geodesic, pt1, pt2, null, CurveDensifyMethod.ByDeviation, -0.0026);

Requirements

Target Platforms: Windows 11, Windows 10, Windows 8.1

Reference

GeometryEngine Class
GeometryEngine Members

Send feedback