Skip To Content

Elevation Profile widget

The Elevation Profile widget generates and displays an elevation profile based on an input path created by drawing or selecting single- or multisegment lines on a web map or scene. The widget can display two elevation profile lines, one for the ground and one for the selected features. Users can choose distance and elevation units and optionally view slope and elevation statistics.

Examples

Use this widget to support app design requirements such as the following:

  • Users can draw or select a path to get the ground elevation profile.
  • Users can select a line to get its profile relative to the ground using z-values or values from elevation fields.
  • Users can view statistics for an elevation profile, such as the slope, the maximum and minimum elevation, and the elevation loss and gain.

Usage notes

This widget requires connecting to a Map widget. To generate an elevation profile for selected line features, the Map widget must be connected to a data source (2D web map or 3D web scene). Line features from map services are not selectable. The widget uses an elevation layer as a surface that provides base heights for the layers in the map. By default, the widget uses the Esri Terrain 3D elevation layer for all web maps and for web scenes without a defined ground layer. You can replace the default Terrain 3D elevation layer with a custom web elevation layer in your map or scene if, for example, you want higher-resolution data for an area of interest.

Note:

To publish custom elevation services, share a tile package using LERC compression format. The service root information should include a property for cacheType: Elevation. Learn more about Tiled Elevation Service.

Tip:

For best results when using web scenes, use the same elevation mode in Scene Viewer for all selectable line layers. If multiple features are selected from line layers that use different elevation modes, the widget displays the features using the elevation mode from the first selected feature.

Settings

The Elevation Profile widget includes the following settings:

  • Source—Select a Map widget.
  • Customize Settings—Optionally, customize the elevation profile settings for the map and each layer. You can change the display settings for the elevation profile graph and the selectable layers.
    • Profile Settings—Customize the settings for the elevation profile graph.
      • Select elevation layer—Use the elevation layer defined in the web scene, or use a custom elevation layer.
        • Use ground elevation layer from web scene—Select this option to use the elevation layer from the web scene to get the results for a drawn or selected line.
        • Use custom elevation layer—Change the default Terrain 3D elevation layer by clicking Set layer to provide a service URL for a custom elevation layer.
          Note:

          The New Zealand elevation layer is an example of a valid elevation layer service:

          https://services1.arcgisonline.co.nz/arcgis/rest/services/Elevation/New_Zealand_Elevation/ImageServer

      • Units—Choose the units used to display the distance and elevation values for the profile graph. By default, the widget uses the units defined in your organization settings. All distance and elevation values are converted to display with these units. For example, when a user selects a line feature that has an elevation of 200 meters and the selected display unit is feet, the widget converts meters to feet and displays an elevation of 656.168 feet.
        Note:

        When the spatial reference is projected using a projection other than Web Mercator and the drawn or selected path is shorter than the geodesic distance threshold, distances are computed planimetrically (independent of elevation).

      • Style—Change the display color for the ground elevation profile in the graph and the color used to highlight the selected line features on the web map or scene.
      • Profile Statistics—Choose which profile statistics to display for the ground elevation, including options for slope, elevation gain and loss, and more. You can drag selected options to reorder them. The statistics are calculated dynamically every time the elevation profile is updated. Users can view statistics by clicking the widget's Profile Statistics button.
    • Advanced Settings—Specify the selectable layers and how the elevation profile for each layer displays in the graph. You must turn on this setting to use the customized selection settings; otherwise, all the selected lines draw on the ground, even if the layer supports z-values (elevation values).
      • Selectable Layers—Choose which line layers can be selected on the map to display an elevation profile. For each selectable layer in the list, configure the following settings:
        Note:

        The Select tool available in the Map widget does not work as a selection tool in the Elevation Profile widget. To generate an elevation profile for a line selection, users must use the Elevation Profile widget's selection tool.

        • Elevation Settings—Specify the data source for the elevation values by selecting one of the following Elevation Type options:
          • Z Value—Use the z-values stored in the layer's geometry. If no units are defined for the vertical z-value in the layer, the units from the ground spatial reference are used. This option is only available if the layer supports z-values.
          • No Elevation—Use the ground elevation for the selected line. (Features with no elevation display on the ground.) This is the default behavior.
          • One Field—Use the selected field that contains elevation data for a line and specify the applicable units for its data.
          • Two Fields—Use two fields that contain elevation data for the start and the end of a line. Specify the applicable units for the data in the selected fields.
        • Style—Change the color, style, and width for line features selected in this layer when they appear in the elevation profile graph.
  • General Settings—Set an active tool for the widget when it opens and customize the appearance of the elevation profile graph.
    • Activate when widget opens—Choose to automatically activate the Select line or Draw profile tool to specify whether users can immediately draw or select a line on the map to generate a profile. (Select line is only available when the Map widget is connected to a data source with line layers.)
    • Appearance—Customize the elements displayed in the elevation profile graph.
      • Graph grids—Display vertical and horizontal grids for each axis.
      • Graph axis titles—Display the titles for the distance and elevation axes.
      • Legend—Display a legend below the graph. Users can click elements in the legend to hide them in the elevation profile.