Skip To Content ArcGIS for Developers Sign In Dashboard

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. Click the Do not open this widget when the app starts button Do not open this widget when the app starts on the widget to turn on the option to open the widget automatically. (For widgets you need to add to the app first, you can make this setting after configuring the widget.)

  1. Hover over the widget and click the Configure this widget button Configure this widget 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.

  2. The configuration window for this widget appears.

    Measurement configuration

    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

  3. For Show measurement tools, check the tool check boxes the widget should display:
    • Area
    • Distance
    • Location
  4. 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.

  5. 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 Location 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.

    Location result with geometry on map

Distance measurements

  1. Click the Distance button Distance.
  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.

    Distance measurement result with geometry on map

Area measurements

  1. Click the Area button Area.
  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.

    Area measurement result with geometry on map