Situation Awareness widget

The Situation Awareness widget allows you to locate an incident on the map and analyze information from different feature layers within a specified incident area.

Configure the Situation Awareness widget

The Situation Awareness widget can be set to open automatically when an app starts. To do so, click the dot on the widget to turn it dark green.

  1. Hover over the widget and click the small edit icon Edit icon. The configuration window for this widget appears.
  2. Optionally click the change widget icon button and replace the icon with your own image.
    A file explorer window appears, allowing you to choose a local image file to use as the widget icon.
  3. On the Analysis tab, click Add Tab. Each tab allows you to specify a feature layer in the map and the type of analysis using one of the following options:
    • Summary—A summary of numeric fields from the selected layer.
    • Proximity—A list of features from the layer that are within the specified area.
    • Closest Feature—The closest feature to the location.
    • Grouped Counts—A count of features within the specific area, grouped by a specified field. Note, if the Grouped Counts option is selected, Group By Field is required. Click the edit button under Actions to define Group By Field.
  4. Optionally, a label can be specified for each tab.
  5. To specify fields to be included in the analysis, click the Edit tool under Actions to open the Select Fields window.
  6. Optionally check Display feature count to see a count added to each tab in the panel.
    Feature count
  7. Optionally change the order of tabs or delete a tab under Actions.
  8. In the General Settings section of the configuration window, you can specify the following options:
    • Tab label—Specify a label for the tab in the widget. The default is Incident.
    • Area of interest label—Specify a label for the area under the tab. The default is Locate Incident.
      Labels for the tab and area
    • Buffer label—Optional label for the buffer distance.
    • Minimum buffer distance—Minimum distance allowed to buffer.
    • Maximum buffer distance—Maximum distance allowed to buffer.
    • Closest feature maximum distance—The maximum distance to use when searching for the closest feature.
    • Enable routing—Check this option to enable routing from the incident to the feature. The Directions widget is also required to generate routes.
    • Disable layer visibility management—Check this option to avoid automated control of layer visibility for the layers used by each tab. When using this option, control layer visibility through other widgets such as the Layer List widget to see map features in a generated report when the reporting capabilities are enabled.
    • Display summary features—Check this option to display the map features for a tab that uses a Summary analysis.
    • Distance units—Select the units to be used for Proximity and Closest Feature analysis, as well as when providing a buffer distance for analysis.
  9. Under Weather Settings, check the Enable weather option if you want to display current and forecasted weather conditions at the incident location. Check Celsius-Kilometers to display metric units for weather and wind speed. You can also use the Select weather layers drop-down arrow to select any weather related layers—such as radar or precipitation—from the currently selected web map that need to be displayed on the map when the Weather tab is selected.
  10. Click the Output tab.
  11. Under Data Output Settings, check the Enable save option to allow users to add or delete features from the feature service. Check Save points, Save lines, or Save polygons, and specify the layer for each selected type.
  12. The Enable snapshot option enables the ability to create a snapshot of the configured app layers at a specific moment in time. This behavior requires specific permissions as shown below:
    Snapshot permission
  13. The Export all fields option, which includes all fields in the layer when exporting to a CSV file, is checked on by default. If you want to only include the fields configured in the Select Fields window for summary, grouped counts, or proximity analyses, uncheck this option.
  14. Under Report Settings, check the Enable report option to support creating a printable report of the map and configured tabs. Optionally upload a logo image for the report by clicking the image icon to choose an image. Optionally provide some text to be displayed in the footnote of the report. Optionally choose a color to display behind the column titles. The printed report will contain a map and a series of tables displaying the analysis results. Fields that are visible in the layer’s pop-up are the fields reflected in the detailed information table for each tab.

Use the Situation Awareness widget

  1. Click the Situation Awareness widget icon to open it. The widget displays at the bottom of the map.
    Display information about an incident

    When the Situation Awareness widget opens, the visibility is turned off for all map layers that have been configured as source layers for the widget unless Disable layer visibility management is enabled. The layers are made visible when used by the widget. When the widget is turned off, layer visibility is returned to its original state.

    The Incident tab is selected by default.

  2. Define a location in one of the following ways:
    • Click an existing feature and choose Set Location in the feature's pop-up window.
    • Use the drawing tools on the widget's Incident tab to create a new location to analyze.
  3. Optionally specify a buffer distance to the location.
  4. To download summarized information, click Download all Download all.
  5. To save the location to the feature service, click Save Save.
  6. To create a snapshot of the location and analyzed information, click Create snapshot Create snapshot.
  7. To create a report of the location and analyzed information, click Create report Report.
  8. To see map features in the generated report, use the Disable layer visibility management configuration setting and enable or disable appropriate layer visibility using other widgets such as the Layer List widget prior to generating the report.
  9. Click the layer tabs to view the analyzed information for specific layers. You can scroll the widget panel horizontally to view additional results.
  10. Optionally click Download Download to download analyzed data as a CSV file.
  11. Optionally, if routing is enabled and the Directions widget has been added to the app, click the directions icon to get directions from the incident to the feature. For line and polygon incidents, enter an appropriate starting point directly in the Directions widget.
  12. To clear the active location, click the Start Over option.
  13. To close the widget, click the Close button in the upper-right corner of the widget.