Measurement widget

The Measurement widget allows the user to measure the area of a polygon, length of a line, or find the coordinates of a point.

Note:

If the map's coordinate system is not Web Mercator or geographic, or if complex polygons are drawn, the Measurement widget needs to use the geometry service to project or simplify geometries.

Caution:

You may notice the difference in buffer operation from the Near Me widget. This is because the Near me widget uses Euclidean buffer (Planar) by default and has an option to choose Geodesic buffer. The Measurement, however, defaults to Geodesic buffer without options.

Configure the Measurement widget

The Measurement widget can be set to open automatically when apps start. To do so, click the dot on the widget to turn it dark green.

Click the edit iconEdit icon on the widget to open the configuration properties.

Measurement configuration

The Default Area Unit parameter allows you to configure the pre-selected unit of measure for polygon measurements. Options are:

  • Acres
  • Sq Miles
  • Sq Kilometers
  • Hectares
  • Sq Yards
  • Sq Feet
  • Sq Meters

The Default Length Unit parameter allows you to configure the pre-selected unit of measure for line/polyline measurements. Options are:

  • Miles
  • Kilometers
  • Feet
  • Meters
  • Yards
  • Nautical Miles

Click OK to close the dialog box when finished.

Use the Measurement widget

Click the widget icon to open the Measurement widget.

Point measurements

Click the point measurement icon Point measurement icon and click a point on the map. The Measurement widget displays the coordinates for the point in Degrees (decimal). You may change the coordinate display format to degrees/minutes/seconds by changing the Degrees drop-down to DMS.

Point measurement result with geometry on map

Polyline measurements

Click the polyline measurement icon Polyline measurement icon and draw a polyline on the map by clicking two or more points. Double-click to finish drawing the polyline. The Measurement widget displays the total length of the polyline, using the defined Default Length Unit. To change the length unit, select the applicable unit of measure from the Milesdrop-down menu.

Polyline measurement result with geometry on map

Polygon measurements

Click the polygon measurement icon Polygon measurement icon and draw a polygon on the map by clicking three or more points. Double-click to finish drawing the polygon. The Measurement widget displays the total area of the polygon, using the defined Default Area Unit. To change the area unit, select the applicable unit of measure from the Acres drop-down menu.

Polygon measurement result with geometry on map