AreaMeasurementAnalysis

AreaMeasurementAnalysis computes the area of a polygonal region and displays the measurement in a 3D SceneView.

To display an area measurement of a polygon, create a new instance of AreaMeasurementAnalysis, add it to SceneView.analyses and set the geometry property.

Use the AreaMeasurementAnalysisView3D to retrieve analysis results.

// create analysis
const areaMeasurement = new AreaMeasurementAnalysis({
  geometry: new Polygon({ })
});

// add to scene view
sceneView.analyses.add(areaMeasurement);

// retrieve measured results from analysis view once available
const analysisView = await sceneView.whenAnalysisView(areaMeasurement);
await reactiveUtils.whenOnce(() => analysisView.result);

const result = analysisView.result;

To draw an area measurement interactively, use the AreaMeasurementAnalysisView3D.place() method.

const abortController = new AbortController();

try {
  await analysisView.place({ signal: abortController.signal });
} catch (error) {
  if (error.name === "AbortError") {
    console.log("Placement operation was cancelled.");
  }
}

// cancel the placement operation at some later point
abortController.abort();

How the area and perimeter are computed depends on the scene's spatial reference and the length of the measured perimeter.

In geographic coordinate systems (GCS) and in Web Mercator:

• If the measurement's perimeter is below 100 km, they are computed in a Euclidean manner, in an ECEF coordinate system (or equivalent on other planets).
• If the perimeter is above 100 km, they are computed geodetically, and the visualization takes the curvature of the planet into consideration.

In projected coordinate systems (PCS), apart from Web Mercator, the area and perimeter are always calculated in a Euclidean manner (in their respective PCS).

The area may be visualized and calculated in two ways:

1. If all the vertices are mostly coplanar (lying on the same plane), the measurement polygon is formed on that plane, and area and perimeter are calculated from its geometry.
2. If the vertices don't form a planar surface, the measurement polygon is projected to a horizontal plane, and area and perimeter are calculated from its geometry.

Use the Area Measurement 3D component to display a user interface for the area measurement analysis.