GeodeticDistanceAndAzimuth Method

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
)

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.
point2: The second input point.
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.
System.MissingMemberException	Both spatial references of point1 and point2 are null.

Remarks

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

Example

SpatialReference sr = SpatialReferences.WGS84;

MapPoint p1 = MapPointBuilder.CreateMapPoint(111, 55, sr);
MapPoint p2 = MapPointBuilder.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

Requirements

Target Platforms: Windows 10, Windows 8.1

Reference

IGeometryEngine Interface
IGeometryEngine Members