ConstructGeodeticLineFromDistance Method (IGeometryEngine)

In This Topic

Constructs a geodetic line with the specified length and azimuth.

Syntax

C#
Visual Basic (Declaration)

Polyline ConstructGeodeticLineFromDistance( 
   GeodeticCurveType curveType,
   MapPoint fromPoint,
   double length,
   double azimuth,
   LinearUnit linearUnit,
   CurveDensifyMethod densifyMode,
   double densifyParameter
)

Function ConstructGeodeticLineFromDistance( _
   ByVal curveType As GeodeticCurveType, _
   ByVal fromPoint As MapPoint, _
   ByVal length As Double, _
   ByVal azimuth As Double, _
   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.
length: The length of the geodetic line to be created.
azimuth: The azimuth (in degrees) of the geodetic line to be created. Measured clockwise from the north.
linearUnit: The linear unit of the length. Also 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	fromPoint is null.
System.ArgumentException	fromPoint cannot be empty.
System.ArgumentException	densifyParameter cannot be NaN.
System.ArgumentException	length cannot be NaN.
System.ArgumentException	azimuth cannot be NaN.
System.ArgumentException	CurveDensifyMethod.ByAngle is not supported.
ArcGIS.Core.Geometry.Exceptions.GenericCOMException	An unspecified error occurred..

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 with specified distance and azimuth

var sr = SpatialReferenceBuilder.CreateSpatialReference(4326);
var mapPoint = MapPointBuilderEx.CreateMapPoint(15, 60, sr);

// calculate
var polylineGeodetic = GeometryEngine.Instance.ConstructGeodeticLineFromDistance(GeodeticCurveType.Loxodrome, mapPoint, 5000000, 45, null, CurveDensifyMethod.ByLength, 300000);

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.

Reference

IGeometryEngine Interface
IGeometryEngine Members

Send feedback