Measurement widget

The Measurement widget allows you 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 will use the geometry service to project or simplify geometries.

Caution:

You may notice a difference in buffer operation from the Near Me widget. This is because the Near Me widget uses a Euclidean buffer (Planar) by default and has an option for a geodesic buffer. The Measurement widget, however, defaults to a geodesic buffer with no other option.

Configure the Measurement widget

The Measurement widget can be set to open automatically when an app starts. To enable this feature, click the dot on the widget, which turns it dark green.

Hover over the Measurement widget and click the edit button Edit. The configuration window for this widget appears.

Measurement configuration

The Default Area Unit parameter allows you to configure the unit of measure for polygon measurements. The options are as follows:

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

The Default Length Unit parameter allows you to configure the unit of measure for line and polyline measurements. The options are as follows:

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

Click OK to close the window when you're finished.

Use the Measurement widget

Click the Measurement widget icon to open it.

Point measurements

Click the point measurement button Point measurement and click a point on the map. The Measurement widget displays the coordinates for the point in degrees (decimal). To change the coordinate display format to degrees/minutes/seconds, change the selection in the Degrees drop-down menu to DMS.

Point measurement result with geometry on map

Polyline measurements

Click the polyline measurement button Polyline measurement 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 button Polygon measurement 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