DirectLineMeasurementAnalysis

DirectLineMeasurementAnalysis computes the distance between two points and displays the measurement in a 3D SceneView.

To display a distance measurement between two points, create a new instance of DirectLineMeasurementAnalysis, add it to SceneView.analyses and set the startPoint and endPoint properties.

Use the DirectLineMeasurementAnalysisView3D to retrieve analysis results.

// create analysis
const directLineMeasurement = new DirectLineMeasurementAnalysis({
  startPoint: new Point({ }),
  endPoint: new Point({ }),
  unit: "imperial"
});

// add to the scene view
sceneView.analyses.add(directLineMeasurement);

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

const result = analysisView.result;

To place the start and end points interactively, use the DirectLineMeasurementAnalysisView3D.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 distances are computed depends on the scene's spatial reference.

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

• Direct distance is computed in a Euclidean manner, in an ECEF coordinate system (or equivalent on other planets);
• Horizontal distance is computed geodetically, taking into consideration the curvature of the planet;
• Vertical distance is computed as an elevation difference.

In projected coordinate systems (PCS), apart from Web Mercator, all three distances (direct, horizontal, and vertical) are computed in a Euclidean manner (in their respective PCS).

DirectLineMeasurementAnalysis visualizes and labels the direct, horizontal, and vertical distances When the distance between the points is greater than 100 kilometers, the measurement visualization is simplified, and in the analysis results only the horizontal and vertical distances are calculated.

Use the Direct Line Measurement 3D component to display a user interface for the direct line measurement analysis.