Method AreaGeodetic
AreaGeodetic(Geometry, AreaUnit, GeodeticCurveType)
Gets the geodesic area of a polygon.
Declaration
public static double AreaGeodetic(this Geometry geometry, AreaUnit unit = null, GeodeticCurveType geodeticCurveType = GeodeticCurveType.Geodesic)
Parameters
Type | Name | Description |
---|---|---|
Geometry | geometry | The geometry to calculate the geodesic area for. |
AreaUnit | unit | The unit of measure for the return value. If |
GeodeticCurveType | geodeticCurveType | The type of curve to calculate. |
Returns
Type | Description |
---|---|
System.Double | The calculated geodesic area in square meters. |
Remarks
The term Geodesic means calculating the shortest distance between two points on a sphere. Using Geodesic algorithms to calculate distances provides a highly accurate way to obtain length and area of measurements of geographic features. The Geodesic algorithm uses the concept of a great circle to obtain the shortest route between two points along the Earth’s surface. The area measurement obtained via this method is typically superior to that of the Area(Geometry) Static Method, as this method is based upon a projection (i.e. a flat 2D representation of a 3D surface) which often introduces distortion depending on the SpatialReference the geometry is in.
The input geometry must be topologically correct to get its accurate area. There are many ways that the orientation or shape of the rings that comprise polygon could be constructed: clock-wise, counter clock-wise, overlapping hourglass, doughnut, multiple independent rings, etc. If the geometry is not topologically correct, then the resultant area from this method could give negative results. It is always a good best practice to use the Simplify(Geometry) Static Method on the geometry such that the resulting geometry is topologically correct and will return accurate and positive area results. Geometries returned by ArcGIS Server services are always correct. Therefore, if you construct geometries programmatically or using the sketch layer, or if you modify geometries returned by ArcGIS Server, you should always simplify them using GeometryEngine.Simplify first.
Applies to
Platforms and versions
Target | Versions |
---|---|
.NET Standard 2.0 | 100.3 - 200.5 |
.NET | 100.13 - 200.5 |
.NET Windows | 100.13 - 200.5 |
.NET Android | 200.0 - 200.5 |
.NET iOS | 200.0 - 200.5 |
.NET Framework | 100.0 - 200.5 |
Xamarin.Android | 100.0 - 100.15 |
Xamarin.iOS | 100.0 - 100.15 |
UWP | 100.0 - 200.5 |