Web AppBuilder for ArcGIS (Developer Edition)

Coordinate Conversion widget

(Added at v2.5)

It is common for analysts to work across various systems that use different coordinate systems to pinpoint places on the earth. For example, one system might use Decimal Degrees (DD) and another system might require the same location to be specified in Military Grid Reference System (MGRS). The Coordinate Conversion widget allows you to input coordinates using one coordinate system and output to different coordinate systems using multiple notation formats.

Configuring the Coordinate Conversion widget

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

  1. Hover over the widget and click the Configure this widget button Configure this widget to open the configuration properties dialog box.
  2. Optionally click the Change widget icon button and replace it with your own image.

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

  3. The graphic for the location to be converted can be changed by clicking the location symbol preview.

    A dialog will give the choice of what symbols can be used.

  4. Set a desired scale for the zoom button, or accept the default.
  5. A table in the configuration page gives you the ability to set what type of coordinates are converted. Set what coordinates the widget will use by checking or unchecking the box next to the coordinate format, by default all coordinate types are selected. The following coordinate formats are supported:
    • Degree-based formats
    • Military Grid Reference System (MGRS)
    • United States National Grid (USNG)
    • Universal Transverse Mercator (UTM)
    • Global Area Reference System (GARS)
  6. Edit the default display of a format by clicking the small edit icon Edit under the edit format column.

    The Edit Default Format window appears. You can add spaces, characters, or change the precision of each coordinate.

Using the Coordinate Conversion widget

Learn how to edit input and output coordinate formats, convert coordinates, and copy coordinates to use in other systems.

Edit input coordinates

You can edit the input coordinate format.

  1. Click the Format Input button next to the Input box.
  2. In the Set Coordinate Format String window, use the drop-down list to select the coordinate format you want.
  3. Edit the text box to change the notation of the input coordinate format.
  4. Check the check box to use a +/- for coordinates in the Northern/Southern or Eastern/Western hemispheres.

Edit output coordinates

You can edit the list of output coordinate formats and their notation.

Edit output coordinate list

You can add and remove coordinate formats.

  1. Click the Add New Notation button to add a new coordinate format.

    Note:

    New coordinates are added to the output as Decimal Degrees.

  2. Remove output formats by clicking the Remove Coordinate button.

Edit output coordinate format

You can edit output coordinate formats.

  1. Click the Format Input button next to the output you wish to format.
  2. In the Set Coordinate Format String window, use the drop-down list to select the coordinate format you want.
  3. Edit the text box to change the notation of the input coordinate format.
  4. Check the check box to use a +/- for coordinates in the Northern/Southern or Eastern/Western hemispheres.

Locate coordinates

You can locate known coordinates.

  1. In the Input box, type or paste coordinates and press Enter.

    A symbol is placed on the map at the location of the input coordinates.

  2. Click the Zoom button to zoom to the input coordinates.

Convert coordinates

You can convert known coordinates or convert coordinates for a location on the map.

Convert known coordinates

You can convert manually input coordinates by typing or pasting coordinates in the Input box. Coordinates will display for the output types you have chosen.

Convert coordinates from the map

You can convert coordinates interactively by clicking a location on the map. Coordinates will display for the output types you have chosen.

Copy coordinates

You can copy output coordinates for use in other systems.

  1. Click the Copy All button to copy all coordinate formats.
  2. Click the Copy to clipboard button next to a coordinate format to copy a single coordinate from the output.
  3. Click the Expand Output button next to a coordinate format to view individual components of a coordinate format.
  4. Click the Copy to clipboard button next to a coordinate format component to copy a single coordinate component.