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

Visual Basic (Declaration)
C#

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

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

Parameters

point1: The first input point. Cannot be null.
point2: The second input point. Cannot be null.
curveType: The geodetic curve type determining how the distance is measured.
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.ArgumentNullException	One or both of the input points are null, or both of the geometry spatial references are null.
System.InvalidOperationException	The spatial references of point1 and point2 are not equal.
System.NotImplementedException	Spatial reference of point1 or point2 is an image coordinate system.

Remarks

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

If one of the spatial references is null and the other is not null and not an image coordinate system, then the non-null spatial reference is used. If both spatial references are null, then an exception is thrown. If both spatial references are not null but not equal, then an exception is thrown. If one of the spatial references is an image coordinate system, then an exception is thrown.

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;

  distance = GeometryEngine.Instance.GeodeticDistanceAndAzimuth(p1, p2, GeodeticCurveType.Geodesic, out double az12, out double 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 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.0 or higher.

Reference

IGeometryEngine Interface
IGeometryEngine Members
Overload List

Send feedback