1. Get started

  2.  Welcome
  3.  Get started
  4.  Run as a Windows service
  5.  Build your first app
  6.  Requirements
  7.  Accessibility support
  8.  Development overview
  9.  About release versions
  10.  What's new
  11.  Frequently asked questions
  12. Working with apps

  13.  Home page
  14.  Create or import an app
  15.  Edit and launch an app
  16.  Choose a theme
  17.  Select a map or scene
  18.  Add widgets
  19.  Widgets overview
  20.  Configure app attributes
  21.  Preview apps on smaller screens
  22.  Export as a template
  23.  Edit or preview template
  24.  Use URL parameters
  25.  Upgrade apps
  26. Configure 2D widgets

  27.  About widget
  28.  Add Data widget
  29.  Analysis widget
  30.  Attribute Table widget
  31.  Batch Attribute Editor widget
  32.  Basemap Gallery widget
  33.  Bookmark widget
  34.  Business Analyst widget
  35.  Chart widget
  36.  Controller widget
  37.  Coordinate widget
  38.  Coordinate Conversion widget
  39.  Cost Analysis widget
  40.  Data Aggregation widget
  41.  Directions widget
  42.  Distance and Direction widget
  43.  District Lookup widget
  44.  Draw widget
  45.  Edit widget
  46.  Emergency Response Guide widget
  47.  Extent Navigate widget
  48.  Filter widget
  49.  Full Screen widget
  50.  Geocoder widget
  51.  GeoLookup widget
  52.  Geoprocessing widget
  53.  Grid Overlay widget
  54.  Gridded Reference Graphic widget
  55.  Group Filter widget
  56.  Image Measurement widget
  57.  Home Button widget
  58.  Incident Analysis widget
  59.  Infographic widget
  60.  Info Summary widget
  61.  Layer List widget
  62.  Legend widget
  63.  Measurement widget
  64.  My Location widget
  65.  Near Me widget
  66.  Network Trace widget
  67.  Oblique Viewer widget
  68.  Overview Map widget
  69.  Parcel Drafter widget
  70.  Print widget
  71.  Public Notification widget
  72.  Query widget
  73.  Related Table Charts widget
  74.  Report Feature widget
  75.  Reviewer Dashboard widget
  76.  Scalebar widget
  77.  Screening widget
  78.  Search widget
  79.  Select widget
  80.  Share widget
  81.  Situation Awareness widget
  82.  Smart Editor widget
  83.  Splash widget
  84.  Stream widget
  85.  Suitability Modeler widget
  86.  Summary widget
  87.  Swipe widget
  88.  Threat Analysis widget
  89.  Time Slider widget
  90.  Visibility widget
  91.  Zoom Slider widget
  92. Configure 3D widgets

  93.  3DFx widget
  94.  About widget
  95.  Basemap Gallery widget
  96.  Compass widget
  97.  Coordinate widget
  98.  Daylight widget
  99.  Full Screen widget
  100.  Home Button widget
  101.  Layer List widget
  102.  Legend widget
  103.  Measurement widget
  104.  My Location widget
  105.  Navigate widget
  106.  Search widget
  107.  Share widget
  108.  Slides widget
  109.  Splash widget
  110.  Zoom Slider widget
  111. Widget development

  112.  Get started
  113.  Naming conventions
  114.  In-panel and off-panel widgets
  115.  Deploy your widget
  116.  Required files
  117.  Widget manifest
  118.  Extend BaseWidget
  119.  Required properties
  120.  Define the template
  121.  Configure the Demo widget
  122.  Add i18n support
  123.  Make widgets user-friendly
  124.  Build your first app
  125.  Communication to app container
  126.  Widget properties
  127.  Make widgets responsive
  128.  Communication between widgets
  129.  Dojo dijit
  130.  Make widgets configurable in builder
  131.  Make widgets backward compatible
  132.  Create a controller widget
  133.  Widget life cycle
  134.  Add help for your widget
  135.  Create a feature action in your widget
  136.  Provide and consume data sources in widgets
  137.  Best practices for unit testing
  138. Theme development

  139.  Theme elements
  140.  Create a theme
  141. 3D development

  142.  3D development guide
  143. Sample code

  144.  Create a custom in-panel widget
  145.  Create a ListView widget
  146.  Create a custom widget using the Report dijit
  147.  Create a new theme
  148.  Create a new style for a theme
  149.  Create a new default layout
  150.  Create a nondefault layout
  151.  Create a new panel
  152.  Create a new layout widget
  153.  Create a controller widget
  154.  Create a feature action in your widget
  155.  Send a layer to the Attribute Table widget
  156.  Open multiple widgets simultaneously
  157.  Use other libraries
  158.  Change the URL of ArcGIS API for JavaScript
  159. Deployment

  160.  Deploy your app
  161.  Use proxy
  162.  Web-tier authentication
  163.  Custom widget and theme deployment
  164.  Upgrade custom widgets and themes
  165. Framework reference

  166.  CSS framework
  167.  FeatureActionManager class
  168.  FilterManager class
  169.  LayerInfo class
  170.  LayerInfos class
  171.  LayerNode class
  172.  LayerStructure class
  173.  PanelManager class
  174.  SelectionManager class
  175.  Utils class
  176.  WidgetManager class
  177. dijit

  178.  FeaturelayerChooserFromMap class
  179.  FeaturelayerServiceBrowser class
  180.  FeatureSetChooserForSingleLayer class
  181.  Filter class
  182.  ImageChooser class
  183.  ItemSelector class
  184.  LayerChooserFromMap class
  185.  RendererChooser class
  186.  Report class
  187.  SnapShot class
  188.  SymbolChooser class
  189. JSON reference

  190.  App configuration
  191.  Map configuration
  192.  Widget configuration
  193.  Widget pool configuration
  194.  Widget on-screen configuration
  195.  Panel configuration
  196.  Group configuration
  197.  DataSource configuration
  198.  About
  199.  Analysis
  200.  Attribute Table
  201.  Basemap Gallery
  202.  Bookmark
  203.  Chart
  204.  Coordinate
  205.  Directions
  206.  Draw
  207.  Edit
  208.  Full Screen
  209.  Geocoder
  210.  Geoprocessing
  211.  Controller
  212.  Home Button
  213.  Image Measurement
  214.  Infographic
  215.  Layer List
  216.  Legend
  217.  Loading Page
  218.  Measurement
  219.  My Location
  220.  Near Me
  221.  Oblique Viewer
  222.  Overview Map
  223.  Print
  224.  Query
  225.  Report Feature
  226.  Reviewer Dashboard
  227.  Scalebar
  228.  Search
  229.  Share
  230.  Splash
  231.  Stream
  232.  Swipe
  233.  Time Slider
  234.  Zoom Slider
  235. What's new archive

  236.  What's new in version 2.23
  237.  What's new in version 2.22
  238.  What's new in version 2.21
  239.  What's new in version 2.20
  240.  What's new in version 2.19
  241.  What's new in version 2.18
  242.  What's new in version 2.17
  243.  What's new in version 2.16
  244.  What's new in version 2.15
  245.  What's new in version 2.14
  246.  What's new in version 2.13
  247.  What's new in version 2.12
  248.  What's new in version 2.11
  249.  What's new in version 2.10
  250.  What's new in version 2.9
  251.  What's new in version 2.8
  252.  What's new in version 2.7
  253.  What's new in version 2.6
  254.  What's new in version 2.5
  255.  What's new in version 2.4
  256.  What's new in version 2.3
  257.  What's new in version 2.2
  258.  What's new in version 2.1
  259.  What's new in version 2.0
  260.  What's new in version 1.3
  261.  What's new in version 1.2
  262.  What's new in version 1.1

Near Me widget

The Near Me widget allows you to find features within a buffer of a defined address or location, view detailed information about those features, and get directions to the selected feature.

Additionally, you can configure the Near Me widget to find polygon features containing a defined address or location instead of polygon features within the buffer.

CautionCaution:

You may notice the difference in buffer operation from the Measurement widget. This is because the Near Me widget uses a Euclidean buffer (planar) by default and has an option to choose a geodesic buffer. The Measurement widget, however, defaults to a geodesic buffer with no options.

NoteNote:

Pop-up media links are not honored by this widget. The click action of the link opens the full-size image instead of opening the configured link.

Configure the Near Me 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.)

Steps:
  1. Hover over the widget and click the Configure this widget button Configure this widget to open the configuration window.
    NoteNote:

    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. Optionally, click Change widget icon and replace it with an image.

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

  3. To configure the Search Source Settings section, see Search widget (the Near Me widget follows the same configuration steps).

    You can optionally add feature layers as the search source for searching features and configure a zoom scale for each feature layer. The default zoom scale is 1:50000. If Zoom to selected feature is enabled on the Search Settings tab and a zoom scale is set for a feature layer, the widget will zoom to the searched feature at the zoom scale set for that layer.

  4. In the Search Settings section of the widget configuration, specify the following options:
    • Search font color for search results—This is the color displayed in the title section of the search results.
    • Set selection color—Specify the color used to highlight selected features. Optionally, turn off this setting if you don't want features highlighted in the map.
    • Select search layer(s)—Select a layer or layers to be configured in the widget.
      NoteNote:

      Search layers must have a pop-up configured.

    • Set Location Button—Enable this option to display the Set Location button next to the search box. Click the button and click the map to set the search location. If you don't enable this option, clicking the map will automatically set the location.
    • Set Current Location Button—Enable this option to display a button that uses the current location as detected by the browser. (This button only appears when the app is being accessed through https.)
    • Only draw selected search layer results—Enable this option to only display features of the layer selected in the listed search results.
    • Set buffer visibility—Enable this option to display the buffer.
    • Buffer Input Options—Choose for users to specify buffer values with a slider or text box or both.
    • Set buffer distance—Define the default value of the buffer slider.
    • Set maximum buffer distance—Define the maximum value of the buffer slider.
    • Buffer distance units—Define the units used by the buffer slider, such as miles, kilometers, meters, or feet.
    • Limit number of results—Specify the maximum number of results to return.
    • Message when no results are found—Configure the message that appears when no features are found within the search area.
    • Use geodesic buffer—Enable this option to generate a geodesic buffer instead of a Euclidean buffer (planar).
      CautionCaution:

      Use a geodesic buffer if the input features have a spatial reference of either WGS84 (WKID 4326) or Web Mercator Auxiliary Sphere (WKID 3857). Only use a Euclidean buffer when input features have a projected coordinate system other than Web Mercator.

    • Address or location symbols—Select and adjust the symbols used to mark the search location.
      NoteNote:

      The point symbol is used for address and proximity search; whereas, the polyline and polygon symbols are used only in the proximity search.

    • Zoom to selected feature—Enable this option to zoom to the selected feature and set a location instead of the buffer.
    • Return intersecting polygon(s)—Enable this option to return the polygon or polygons containing the searched location rather than polygons within the buffer.
    • Enable proximity search—Enable searching for locations near a selected result.
    • Show image gallery—Show an image gallery in the widget panel.
    • Show count of search results for each layer—Display the number of search results returned next to each layer name.
    • Show results for all configured layers regardless of their visibility status—Display results for all configured layers, including layers that are turned off in the Layer List.
    • Introductory text—Customize the introductory text that appears for the search box.
  5. NoteNote:

    The widget uses many elements from the map. The list of features displays the layer names in the map, the results of each layer display the pop-up title from the map, and the information panel displays the contents of the configured pop-up.

    Near Me results only include features for configured layers that are turned on in the map (instead of automatically turning on those layers). If necessary, include the Layer List widget in your app so users can turn on layers that are off in the source map.

  6. Optionally, in the Directions Settings section of the widget configuration, set up the widget to use routing, which allows you the option to get driving directions to the selected feature. To configure the Directions Settings section of the widget configuration, specify the following options:
    • Routing Service—Click Set and browse to a routing service in your ArcGIS Online organizational account, or provide the URL to the routing service.
      LicenseLicense:

      The ArcGIS Online World Route Service consumes credits. Before generating routes using this service, on the Attributes tab for the configuration of your Web AppBuilder application, configure Subscriber content access with the URL of the routing service used by your widget.

      Learn more about credit usage when creating simple routes

    • Direction length units—Select the units to display directions (kilometers or miles).
    • Select symbol to display route—Select the display symbol, color, style, transparency, and width for the route.
  7. NoteNote:

    Routing parameter settings in the web map has been removed in ArcGIS Online 7.2. This parameter is configurable in this widget under the Directions Settings tab.

  8. Use graphics to represent attribute values, such as pictographs for the amenities that are available at a facility. Configure these graphics in the Symbology Settings section of the widget configuration by doing the following:
    1. Click Add New Symbols to add a new symbol.
    2. Choose a layer, field, and value for that field to represent with a graphic.
    3. Choose a symbol to represent that value in that field and that layer.

      This graphic displays in the Near Me panel below the pop-up attributes and above any attachments. The graphic representation of the attribute displays even when the attribute is hidden in the pop-up.

    4. To remove a graphic, click the Delete button in the Actions column.
  9. Allow your users to filter the search results to help them find the right information. Configure these filters in the Filter Settings section of the widget configuration by doing the following:
    1. Click New Filter and select a layer from the Layer drop-down list.
    2. Under the Info tab, name the filter in the Label text box.
    3. Choose an icon or browse to your local images to choose an icon for the filter; otherwise, the default icon is used.
    4. Under the Expressions tab, click + Add expression.
      1. Click the field drop-down arrow and choose the field you want to filter against from the list.
      2. Click the operators drop-down arrow and choose an operator from the list.

        NoteNote:

        Date-related value providers now can provide relative dates, such as today, yesterday, and tomorrow. Date-related operators, such as in the last and not in the last, can also support the setting of relative dates (for example, in the last five days). Note that certain date-related operators, such as in the last and not in the last, are only available for online-hosted feature services.

        The is any of and is none of operators accept multiple values of a field as input. With one of the operators, your expression can get data that matches any or none of the selected values.

      3. To filter based on a specific value, click the settings button, choose Value, and specify a value in the field. Optionally, click the box to the left of Ask for values to set up an interactive expression. Type information about the value in the Prompt field and a hint in the Hint field. Select one or more values from the List values drop-down list to use to filter the layer.
      4. To compare the value in one field to the value in another field, choose Field in the settings, click the drop-down arrow, and choose the field for your expression.
      5. To filter based on a specific value in the field, choose Unique in the settings to retrieve a dynamic list of values from the layer, or choose Unique (predefined) to predefine a static list of values. It also allows you to dynamically show the values based on the previous expressions or all other expressions regardless of their orders. Provide information about the value in the Prompt field and a hint in the Hint field, and select how the values are listed.

        CautionCaution:

        Unique value filters require a 10.1 or later map service layer. The Unique option does not appear if you are creating a filter on a 10.0 or earlier service layer.

        CautionCaution:

        To display descriptions for coded values when Values filtered by previous expressions or Values filtered by all other expressions is selected, the service must support the capability of query by statistics.

      6. To filter on multiple values in the field, choose Multiple in the settings to retrieve a dynamic list of values from the layer, or choose Multiple (predefined) to predefine a static list of values. Note that only the is any of and is none of operators support multiple values.

        NoteNote:

        If you created an expression based on values or a unique value, you can set up an interactive expression by checking the box to the left of Ask for values. You cannot ask for values on expressions based on a field.

    5. To create multiple expressions, or one or more sets of expressions, click + Add expression or Add set.

      A set is a grouping of expressions, for example, Shelter capacity is greater than 200 and Status is open.

    6. Under the Options tab, check the Remove the preset layer filters from the map box if you don't want to carry over the filters in the map to your app.
      • Optionally, check Apply this filter when the widget is opened to apply the filter immediately when the widget is opened.
      • Optionally, check the Collapse the filter expression (if any) when the widget is opened option to collapse the filter with Ask for values.
    7. To add another filter, repeat steps a through f.
      NoteNote:

      When adding multiple filters, you can display features that match any or all filters.

    8. Hover over the filter you created in the table to delete or reorder it.
    9. Check the Collapse the filter expression (if any) when the widget is opened option to collapse the filter with Ask for values.
    10. Optionally, select Group filter by layer to sort the filters by the layer they impact.
    11. Check Expand filters when widget is open to expand the filter at runtime.
    12. Click OK to save and close the configuration.

Use the Near Me widget

To use the Near Me widget, complete the following steps.

Steps:
  1. Click the Near Me widget button to open it.
  2. Define the area you want to buffer by adjusting the slider to the desired number.
  3. Search for an address in the search bar or click a location on the map to define the location to be buffered.

    Features found within the defined buffer for each layer are listed, as well as a count of how many features belong to each layer.

    Features found within the buffer distance

  4. Click a layer in the list of results and click the desired feature.

    Information about the selected feature

    Information about the feature is shown on the Information tab.

  5. NoteNote:
    If the widget is configured for one layer, all the features found for that layer are listed.
  6. Click the Directions tab if the widget is configured to provide driving directions.

    Driving directions to the selected feature from the defined location are shown.