Skip To Content

Configure Indoors

After ArcGIS Indoors Web is deployed as configurable app to your portal, you can also update the JSON configuration file to point to the values that apply to your deployment.

Caution:

Before updating this file, try the default configuration first. Make changes only if the default configuration won't work.

General configuration

PropertyDescription

webmap

The ID of the web map used in the app.

Note:

This should remain null when using the app as a template.

webscene

The ID of the 3D web scene used in the app.

Note:

This should remain null when using the app as a template.

portalUrl

This should always be set to ../..

oauthAppId

If deployed as an app template, this value should always be set to indoorsweb.

networkServiceUrl

The full URL to the network service used by the Directions widget. Setting it here will enable the same service for all apps created from this template, and will override anything set in the IndoorsConfig table in your Indoorsweb maps.

Note:

Set this value to null if using the value set in the IndoorsConfig table in the web map.

https://webadaptorhost.domain.com/webadaptorname/rest/services/AIIM/EsriRedlandsNetwork

closestFacilityServiceUrl

The complete url of the network service used by the Directions widget. Setting it here will enable the same service for all apps created from this template, and will override anything set in the IndoorsConfig table in your Indoors web maps.

Note:

Set this value to null if using the value set in the IndoorsConfig table in the web map.

allowAnonymousAccess

If set to false all users will need to log in with a valid portal ID to access the web app.

If set to true, the application can be accessed anonymously.

allowNonAiimIdentify

The value used by the app to control the identify functionality on the info panel on basic layers.

  • True: Enables the identify functionality on basic layers if their pop-up is configured.
  • False: Disables the identify functionality, even if the pop-up is enabled for the basic layers in the map.
Note:

The basic layers can be any point, line, or polygon features that do not conform to the required ArcGIS Indoors Information Model layers.

defaultVerticalOrder

The initial building level (floor) used by the app when loaded. This value will override any value that may be set in the web map or scene.

graphicElevationOffset

The distance to have the highlight, point symbol, and route graphics hover over the floors in the 3D scene. It is recommended to set this value to make these graphics more visible when in 3D mode.

Note:

The unit of measurement is meters.

maxFavoritePlaces

The threshold for the number of favorites stored in the app.

maxRecentPlaces

The upper threshold for the number of recent places the app will store.

minScaleFacilityLabels

The lower threshold for displaying labels for buildings in the map. This value is set in ArcGIS Pro before sharing the web map.

proximityMaxItemsToSort

The number of explore candidates to send to the Closest Facility service and sort by distance to the home location.

Note:

Setting this value to a high number can affect application performance.

proximityMetersPerLevel

A rough distance to add to the proximity of an item on a different level from the home location used to refine the proximity sort results.

setLevelFromHome

If the home location is set in the app, it will default to the home location facility and level on page load. If set to false, the app will load to the default map extent.

setLevelOnStart

If the home location is set in the app, it will default to the home location facility and level on page load. If set to false, the app will load to the default map extent.

supportedBrowserUrl

See Indoors Web system requirements.

facilityHighlightOnHover2D

This is set to true to highlight the building outlines or Facilities on hover, when the Facilities layer is visible.

facilityHighlightSymbol2D

The polygon marker symbol settings used to display the highlight for the facilityHighlightOnHover2D setting.

categories

This section of the configuration file overrides what is in the categories table. The values need to be set to what you want to see for that category in the Explore widget. This also sets some of the behavior if the categories are used as filters for the text-based search.

Note:

It is recommended to set these values in the categories table.

Caution:

Settings here will override settings in the Categories table.

  1. uniqueIDField: Unique identifier for the POI layer used
  2. displayField: Field that contains the category name to display
  3. subTitleField: The field (AIIM) that contains secondary name information
  4. searchFields: The fields to search against in a textual search if the category is selected as a filter
  5. suggestionTemplate: Combination of attribute values that show as a hint in the search box if the category is selected as a filter

  1. Open the app's config.json file in a text editor of your choice to update the settings.

    This file is located at <App installation location>\ArcGIS\Portal\apps\indoors\app\config.

  2. Edit the values as necessary.
  3. Save the file.

Configure icons for events, units, levels, and facilities

The Events, Units Levels, and Facilities layers use the default icons located in the Indoors app folder at <App installation location>\ArcGIS\Portal\apps\indoors\assets\category-default.svg. The config.json file can be modified to replace these icons.

  1. Open the app's config.json file in a text editor of your choice to update the settings.

    This file is located at <App installation location>\ArcGIS\Portal\apps\indoors\app\config.

  2. Scroll to the “categories” section.
  3. Add the "iconUrl" property, along with a URL to an image, for the categories for which you want to update the icon (Events, Units, Levels, or Facilities).

    This sample configures an iconUrl for Levels (using a relative path) and Facilities (from the internet).

    "categories": {
        "fill": {
          "Events": {
            "name": "Events",
            "uniqueIdField": "event_id"
          },
          "Units": {
            "name": "Units",
            "uniqueIdField": "unit_id"
          },
          "Levels": {
            "name": "Levels",
            "uniqueIdField": "level_id",
            "iconUrl": "./assets/indoors-logo.svg"
          },
          "Facilities": {
            "name": "Facilities",
            "uniqueIdField": "facility_id",
            "iconUrl": "https://enterprise.arcgis.com/assets/img/logo/esri-logo.svg"
          }
        }
      }
    
  4. Save the file.