GeodeticDistanceAndAzimuth(MapPoint,MapPoint,GeodeticCurveType,Double,Double) Method

In This Topic

Calculates distance and azimuth on the spheroid between two points using the given geodetic curve type.

Syntax

C#
Visual Basic (Declaration)

double GeodeticDistanceAndAzimuth( 
   MapPoint point1,
   MapPoint point2,
   GeodeticCurveType curveType,
   out double azimuth12,
   out double azimuth21
)

Overloads Function GeodeticDistanceAndAzimuth( _
   ByVal point1 As MapPoint, _
   ByVal point2 As MapPoint, _
   ByVal curveType As GeodeticCurveType, _
   ByRef azimuth12 As Double, _
   ByRef azimuth21 As Double _
) As Double

Parameters

point1: The first input point. Cannot be null and its spatial reference cannot be null.
point2: The second input point. Cannot be null and its spatial reference cannot be null.
curveType: The geodetic curve type.
azimuth12: The azimuth from point1 to point2 in radians.
azimuth21: The azimuth from point2 to point1 in radians.

Return Value

Geodetic distance between the two points in meters.

Exceptions

Exception	Description
System.NotImplementedException	Spatial reference of point1 or point2 is an image coordinate system.
System.ArgumentNullException	One or both of the input points are null, or one or both of the geometry spatial references are null.

Remarks

If point1 or point2 are empty, then azimuth12 = 0, azimuth21 = 0 and the returned geodetic distance is NaN.

Example

Calculate geodetic distance, azimuth between two points

SpatialReference sr = SpatialReferences.WGS84;

MapPoint p1 = MapPointBuilderEx.CreateMapPoint(111, 55, sr);
MapPoint p2 = MapPointBuilderEx.CreateMapPoint(95.5845, 64.2285, sr);

double distance, az12, az21;

distance = GeometryEngine.Instance.GeodeticDistanceAndAzimuth(p1, p2, GeodeticCurveType.Geodesic, out az12, out az21);
// distance - 1339728.0303777338
// az12 - 326.235780421405
// az21 - 132.87425637913955

distance = GeometryEngine.Instance.GeodeticDistanceAndAzimuth(p1, p2, GeodeticCurveType.Loxodrome, out az12, out az21);
// distance - 1342745.9687172563
// az12 - 319.966400332104
// az21- 139.96640033210397

distance = GeometryEngine.Instance.GeodeticDistanceAndAzimuth(p1, p2, GeodeticCurveType.GreatElliptic, out az12, out az21);
// distance - 1339728.038837946
// az12 - 326.22479262335418
// az21 - 132.88558894347742



MapPoint p3 = MapPointBuilderEx.CreateMapPoint(0, 0, sr);
MapPoint p4 = MapPointBuilderEx.CreateMapPoint(1, 0, sr);

distance = GeometryEngine.Instance.GeodeticDistanceAndAzimuth(p3, p4, GeodeticCurveType.Geodesic, out az12, out az21);
// distance - 111319.49079327342
// az12 - 90
// az21 - 270

distance = GeometryEngine.Instance.GeodeticDistanceAndAzimuth(p3, p4, GeodeticCurveType.Geodesic, LinearUnit.Miles, out az12, out az21);
// distance - 69.1707247134693
// az12 - 90
// az21 - 270

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.

Reference

IGeometryEngine Interface
IGeometryEngine Members
Overload List

Send feedback