Skip to content

labelPointOperator

ESM: import * as labelPointOperator from "@arcgis/core/geometry/operators/labelPointOperator.js";
CDN: const labelPointOperator = await $arcgis.import("@arcgis/core/geometry/operators/labelPointOperator.js");
Object: @arcgis/core/geometry/operators/labelPointOperator
Since: ArcGIS Maps SDK for JavaScript 4.31

Calculates a label point for the given 2D geometries. The point is guaranteed to be on the interior of the geometry. It can be used to place a label on a feature and help to ensure readability on the map.

Based on the input geometry type, the label point is defined as follows:

  • Extent - the center of the extent.
  • Multipoint - the point which is closest to the center of the geometry's envelope.
  • Point - the point itself.
  • Polygon - a point near the centroid of the ring with greatest area.
  • Polyline - a vertex near the middle of the longest segment.

Property Overview

Name Type Summary Object

Indicates if the operator supports input geometries that contain curves.

labelPointOperator

Property Details

supportsCurves

Property
supportsCurves Booleanreadonly

Indicates if the operator supports input geometries that contain curves. The value will always be true.

Method Overview

Name Return Type Summary Object

Performs the label point operation on the geometry.

labelPointOperator

Performs the label point operation on the geometry set.

labelPointOperator

Method Details

execute

Method
execute(geometry){Point}

Performs the label point operation on the geometry.

Parameter
geometry GeometryUnion

The input geometry.

Returns
Type Description
Point Returns the label point.
Example
// Perform the label point operation
const labelPoint = labelPointOperator.execute(polygon);

executeMany

Method
executeMany(geometries){Point[]}

Performs the label point operation on the geometry set.

Parameter
geometries GeometryUnion[]

The set of input geometries. All the geometries must have the same spatial reference.

Returns
Type Description
Point[] Returns the label points for each geometry.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.