GeodesicArea(Geometry,AreaUnit) Method

In This Topic

Gets the geodesic area of a geometry.

Syntax

Visual Basic (Declaration)
C#

Overloads Function GeodesicArea( _
   ByVal geometry As Geometry, _
   ByVal areaUnit As AreaUnit _
) As Double

double GeodesicArea( 
   Geometry geometry,
   AreaUnit areaUnit
)

Parameters

geometry: The input geometry. Cannot be null and its spatial reference cannot be null.
areaUnit: The unit of the output area. If null, then the area is square meters.

Return Value

The calculated geodesic area in . If is null, the geodesic area is in square meters.

If the geometry is empty, then zero is returned.

Exceptions

Exception	Description
System.ArgumentNullException	Geometry is null or geometry's spatial reference is null.
System.NotImplementedException	The method is not implemented for GeometryBag or Multipatch.
System.NotImplementedException	Spatial reference of geometryis an image coordinate system.

Example

Calculate the Geodesic Area of a polygon

{
  polygon = PolygonBuilderEx.CreatePolygon(
  [
    MapPointBuilderEx.CreateMapPoint(-10018754.1713946, 10018754.1713946),
    MapPointBuilderEx.CreateMapPoint(10018754.1713946, 10018754.1713946),
    MapPointBuilderEx.CreateMapPoint(10018754.1713946, -10018754.1713946),
    MapPointBuilderEx.CreateMapPoint(-10018754.1713946, -10018754.1713946)
  ], SpatialReferences.WebMercator);
  var area = GeometryEngine.Instance.GeodesicArea(polygon);

  // area is close to 255032810857732.31

  area = GeometryEngine.Instance.GeodesicArea(polygon, AreaUnit.SquareKilometers);
  // area is close to 255032810.85953, 
}

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