Skip To Content
ArcGIS Developer
Dashboard

Distance and Direction widget

(Added at v2.8)

The Distance and Direction widget allows you to draw lines, circles, ellipses, and range rings to visualize important information.

License:

If you include this widget in your app, confirm that your end users have the required privileges described in the Use this widget section.

Configure the Distance and Direction 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 Do not open this widget when the app starts 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 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. To replace the widget icon with your own, click the Change widget icon button.

    A file explorer window appears, allowing you to select a local image file to use as the widget icon.

  3. In the Distance and Direction Feedback Style section, use the check boxes to choose which tabs will display when the widget is deployed. By default, Show all tabs is on to display all tabs.
  4. Click on the preview icon to edit the symbology for each tab.
  5. Use the color picker in Feedback label text color to set the color used to label graphics.
  6. Use the text box in Feedback label text size to set the text size used to label graphics.
  7. In the Distance and Direction Feedback Results Layer section, configure the following settings:
    • Select an operational polyline layer for line and rings results—Choose a polyline layer to which users can save results.
    • Select an operational polygon layer for circle and ellipse results—Choose a polygon layer to which users can save results.
    Note:

    These lists only include layers from your organization. If the map uses feature layers from another organization, they do not appear in the lists.

Use the Distance and Direction widget

You can use the Distance and Direction widget to create lines, circles, ellipses, or rings.

Change the input coordinate format

The Distance and Direction widget allows you to change the way coordinates are displayed in the coordinate text box. The Format Input and Add Point tools are located by the Start Point and End Point for the line tab, and Center Point for the circle, ellipse and range rings tabs.

  1. Click the Format Input button next to any coordinate text box to open the Set Coordinate Format String window.
  2. Click the drop-down menu and choose a coordinate display format.
  3. Format the coordinate string by adding characters or spaces or removing components of the string in the text box.
  4. Optionally check the box to add a + or - prefix to positive or negative numbers.
  5. Click OK.

Edit symbology

You can edit the symbology of a line, circle, ellipse, or range ring. Each tab has a Symbol and label settings section that provides the option to change how graphics are displayed.

  1. In the Symbol and label settings section, click Symbology Preview and make changes.
  2. For Label color and size, click the color picker to set the color and use the text box to set the text size used to label a graphic.

Create lines

You can create lines using the Distance and Direction widget given a distance and bearing, from known coordinates, or by interactively selecting points.

Create lines from distance and bearing

Create lines from a given distance and bearing.

  1. Click the Line tab.
  2. Click the From menu and choose Distance and Bearing.
  3. Set a start point by entering coordinates in the Start Point text box and pressing Enter, or use the Add Point tool to interactively select a point.
  4. Optionally use the Format Input button to open the Set Coordinate Format String window.
  5. Enter a value for Length and set the units.
  6. Enter a value for Angle and set the units.
  7. Click OK.
  8. In the Publish Graphics pane, optionally save the result by publishing a hosted feature layer.
  9. To remove the graphics from the map, click Back and click Clear Graphics.

Create lines from coordinates

Use known coordinates to create geodesic lines.

  1. Click the Line tab.
  2. Click the From menu and choose Points.
  3. Set a start point by entering coordinates in the Start Point text box and pressing Enter, or use the Add Point tool to interactively select a point.
  4. Optionally use the Format Input button to open the Set Coordinate Format String window.
  5. Set an end point by entering coordinates in the End Point text box and pressing Enter, or use the Add Point tool to interactively select a point.
  6. Optionally use the Format Input button to open the Set Coordinate Format String window.
  7. If you typed coordinates for the start and end points, click OK to create the line.
  8. Click OK if you want to save the result by publishing a hosted feature layer.
  9. To remove the graphics from the map, click Clear Graphics.

Create lines interactively

Interactively create geodesic lines on the map.

  1. Click the Line tab.
  2. Click the From menu and choose Points.
  3. Check the Create Line Interactively box.
  4. Click the Draw Line tool.
  5. Click a location on the map to designate the line starting point.
  6. Click a second point on the map to designate the line ending point.
  7. Click Publish if you want to save the result by publishing a hosted feature layer.
  8. To remove the graphics from the map, click Clear Graphics.

Create circles

You can create circles using the Distance and Direction widget from known coordinates, interactively, or from a given time and speed.

Create circles from known coordinates

Use known coordinates to create circles using radius or diameter lengths.

  1. Click the Circle tab.
  2. Click the Create Circle From menu and choose Radius or Diameter.
  3. Set a center point by entering coordinates in the Center Point text box and pressing Enter, or use the Draw Circle tool to interactively select a point.
  4. Enter a distance in the Radius or Diameter text box and choose the desired units.
  5. Click OK.
  6. In the Publish Graphics pane, optionally save the result by publishing a hosted feature layer.
  7. To remove the graphics from the map, click Back and click Clear Graphics.

Create circles interactively

Interactively create circles by clicking the map.

  1. Click the Circle tab.
  2. Click the Create Circle From menu to choose a drawing method. Choose Radius or Diameter.
  3. Check the Create Circle Interactively box.
  4. Click the Radius/Diameter units menu to set the distance units.
  5. Click the Draw Circle tool.
  6. Click a point on the map to designate the circle's center.
  7. Click a second point on the map to designate the circle's radius or diameter.
  8. Click Publish if you want to save the result by publishing a hosted feature layer.
  9. To remove the graphics from the map, click Clear Graphics.

Create circles using speed and time

Create a circle to identify potential locations for moving objects using a center point, time, and speed.

  1. Click the Circle tab.
  2. Click the Create Circle From menu and choose Radius or Diameter.
  3. Set a center point by entering coordinates in the Center Point text box and pressing Enter, or use the Draw Circle tool to interactively select a point.
  4. Expand Distance Calculator to enter the other options.
  5. Enter a value for Time and set the units.
  6. Enter a value for Rate and set the units.
  7. Click OK.
  8. In the Publish Graphics pane, optionally save the result by publishing a hosted feature layer.
  9. To remove the graphics from the map, click Back and click Clear Graphics.

Create ellipses

The Distance and Direction widget can create ellipses from either known coordinates or interactively.

Create ellipses from known coordinates

You can use known coordinates to create ellipses.

  1. Click the Ellipse tab.
  2. Click the Ellipse Type menu and choose either Semi or Full.
  3. Set a center point by entering coordinates in the Center Point text box and pressing Enter, or use the Draw Ellipse tool to interactively select a point.
  4. Enter values for the Major and Minor axes in the Axis section and choose a value from the Units menu.
  5. Enter a value for Orientation Angle and set the units.
  6. Click OK.
  7. In the Publish Graphics pane, optionally save the result by publishing a hosted feature layer.
  8. To remove the graphics from the map, click Back and click Clear Graphics.

Create ellipses interactively

Interactively create ellipses by clicking the map.

  1. Click the Ellipse tab.
  2. Click the Ellipse Type menu and choose Semi or Full.
  3. Check the Create Ellipse Interactively box.
  4. Click the Unit menu in the Axis section to change the axis units.
  5. Click the Draw Ellipse tool.
  6. Click a point on the map to designate the ellipse center.
  7. Drag the pointer and click the map to designate the ellipse major axis length and orientation.
  8. Drag and click the map to designate the ellipse minor axis length.
  9. Click Publish if you want to save the result by publishing a hosted feature layer.
  10. To remove the graphics from the map, click Clear Graphics.

Create rings

You can create range rings with the Distance and Direction widget by interactively drawing on the map or specifying known coordinates and ring intervals. When drawing range rings from known distances between rings, rings can be drawn based on fixed intervals, distance from the origin point, or cumulative distance from the previous ring.

Create range rings interactively

Interactively create range rings by clicking the map.

  1. Click the Rings tab.
  2. Click the Type menu and choose Interactive.
  3. Use the Distance Units menu to set the units.
  4. Type a value in the Number of Radials text box.
  5. Click the Add Point tool.
  6. Click the map to designate a center point.
  7. Drag the pointer and click the map to designate the first ring.
  8. Add more rings as needed.
  9. Double-click the map to complete the range rings.
  10. Click Publish if you want to save the result by publishing a hosted feature layer.
  11. To remove the graphics from the map, click Clear Graphics.

Create range rings using a fixed ring number and distance

Create range rings using a set ring number and distance with the Distance and Direction widget.

  1. Click the Rings tab.
  2. Click the Type menu and choose Fixed.
  3. Set a center point by entering coordinates in the Center Point text box and pressing Enter, or use the Add Point tool to interactively select a point.
  4. Type a value in the Number of Rings text box.
  5. Type a value in the Distance Between Rings text box and set the desired units.
  6. Type a value in the Number of Radials text box.
  7. Click OK.
  8. In the Publish Graphics pane, optionally save the result by publishing a hosted feature layer.
  9. To remove the graphics from the map, click Back and click Clear Graphics.

Create range rings by distance from an origin

Create range rings based on an origin and distance from the origin.

  1. Click the Rings tab.
  2. Click the Type menu and choose Origin.
  3. Set a center point by entering coordinates in the Center Point text box and pressing Enter, or use the Add Point tool to interactively select a point.
  4. Use the Distance Units menu to set the units.
  5. Enter a value in the Distances text box to set how far the first ring will be from the origin point.
  6. Click the add button to add another value, and continue to add values as necessary.
  7. Optionally hover over a value and click the delete button to delete that value.
  8. Type a value in the Number of Radials text box.
  9. Click OK.
  10. In the Publish Graphics pane, optionally save the result by publishing a hosted feature layer.
  11. To remove the graphics from the map, click Back and click Clear Graphics.

Create range rings by distance between rings

Create range rings based on an origin and distance from the previous ring.

  1. Click the Rings tab.
  2. Click the Type menu and choose Cumulative.
  3. Set a center point by entering coordinates in the Center Point text box and pressing Enter, or use the Add Point tool to interactively select a point.
  4. Use the Distance Units menu to set the units.
  5. Enter a value in the Distances text box to set how far the first ring will be from the origin point.
  6. Click the add button to add another value, and continue to add values as necessary.
  7. Optionally hover over a value and click the delete button to delete that value.
  8. Optionally hover over a value and click the up or down arrow to reorder the values.
  9. Type a value in the Number of Radials text box.
  10. Click OK.
  11. In the Publish Graphics pane, optionally save the result by publishing a hosted feature layer.
  12. To remove the graphics from the map, click Back and click Clear Graphics.

Publish graphics as a layer

Publish distance and direction graphics as a hosted feature layer to a portal or organizational account.

Note:

To publish results, you must have an organizational account with publishing privileges.

  1. In the Published Layer Name text box, type a name for the hosted feature layer or select an existing hosted feature layer.
  2. Click Publish.
  3. If you're prompted to sign in, enter your username and password.
  4. Click OK.