Measurement widget

(Added at v1.0)

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

Note:

For the most accurate results, use Web Mercator for the geographic type of spatial references. For other spatial references or complex polygons, a simplification process is applied to address the distortion caused by spatial projections or complicated polygons.

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

This widget can be set to open automatically when an app starts. Hover over the widget and click the Do not open this widget when the app starts button to change the setting to Open this widget automatically when the app starts. (For widgets that you need to add to the app first, you can turn on this option after configuring the widget.)

1. Hover over the widget and click the Configure this widget button to open the configuration window.

   Note:

   If you need to add the widget to the app first, click a widget placeholder on the Widget tab. In the Choose Widget window that opens, select the widget and click OK.

The configuration window for this widget appears.



The Default area unit parameter allows you to configure the unit of measure for area (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 distance (line and polyline) measurements. The options are as follows:

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

2. For Show measurement tools, check the tool check boxes the widget should display:
   • Area
   • Distance
   • Location
3. Optionally, check the Add the measure graphic as an operational layer of the map check box.

   This allows you to create your measurements and have the graphic display in the layers window. If this option is not selected, your measurement will display but won't be added to the layers window.

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

When measuring an area, distance, or location, you can close the widget or switch to a different widget and your measurements remain. To delete the measurement graphics, open the measurement tool and select Clear.

Use the Measurement widget

Click the Measurement widget icon to open it.

Location measurements

1. Click the Location button and click a location 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.

   

Distance measurements

1. Click the Distance button .
2. Draw a polyline on the map by clicking two or more points.
3. 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 Miles drop-down menu.

   

Area measurements

1. Click the Area button .
2. Draw a polygon on the map by clicking three or more points.
3. 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.