geodeticAreaOperator | API Reference | ArcGIS Maps SDK for JavaScript

geodeticAreaOperator

ESM: import * as geodeticAreaOperator from "@arcgis/core/geometry/operators/geodeticAreaOperator.js";

CDN: const geodeticAreaOperator = await $arcgis.import("@arcgis/core/geometry/operators/geodeticAreaOperator.js");

Object: @arcgis/core/geometry/operators/geodeticAreaOperator

Since: ArcGIS Maps SDK for JavaScript 4.31

Returns the geodetic area of a 2D geometry.

Notes

Verify that isLoaded() returns true before using this module.
Use load() to load this module's dependencies.

Property Overview

Name	Type	Summary	Object
	Boolean\|null\|undefined	Indicates if the operator supports input geometries that contain curves.	geodeticAreaOperator

Property Details

supportsCurves Property supportsCurves Boolean |null |undefinedreadonly

Indicates if the operator supports input geometries that contain curves. The value is null or undefined until the operator is loaded, then it will always be true.

Method Overview

Return Type	Summary	Object
Number	Calculates the geodetic area of the input Geometry.	geodeticAreaOperator
Boolean	Indicates if all dependencies of this module have been loaded.	geodeticAreaOperator
Promise	Loads this module's dependencies.	geodeticAreaOperator

Method Details

execute Method execute(geometry, options){Number}

Calculates the geodetic area of the input Geometry. Unless the unit option is set, the default is square-meters.

Parameters

Specification

geometry GeometryUnion

The input geometry.

options Object

optional

Additional options.

Specification

curveType String

optional

Default Value: "geodesic"

The type of geodetic curve used to determine the area.

Possible Values:"geodesic"|"loxodrome"|"great-elliptic"|"normal-section"|"shape-preserving"

unit AreaUnit

optional

Default Value: "square-meters"

The area unit of the return value.

Returns

Type	Description
Number	Returns the geodetic area of the input geometry.

Example

if (!geodeticAreaOperator.isLoaded()) {
  await geodeticAreaOperator.load();
}

// Calculate the geodetic area of a polygon.
const area = geodeticAreaOperator.execute(polygon);

isLoaded Method isLoaded(){Boolean}

Indicates if all dependencies of this module have been loaded.

Returns

Type	Description
Boolean	Returns `true` if this module's dependencies have been loaded.

load Method load(){Promise}

Loads this module's dependencies. This method must be called first if isLoaded returns false.

Returns

Type	Description
Promise	Resolves when the dependencies have been loaded.

See also

isLoaded