Launch directly to a feature or route

Available with the ArcGIS Indoors Maps extension.

You can configure Indoor Viewer to launch directly to a feature or a route between two features (a smart launch). The smart launch functionality is enabled using parameters in the app’s URL.

Launch to a feature

You can configure the Viewer app to launch directly to a specific feature. The URL for launching to a feature is automatically generated using the Share button as follows:

  1. Select a feature in the Viewer app.

    The info panel appears with details about the selected feature.

  2. Click the Share button Share at the top of the info panel and click Copy to Clipboard.

    The URL is copied to the clipboard.

  3. Open a browser window and paste the URL there.

    The generated URL launches the Viewer app to the specified feature.

URL parameters

The URL generated using the Share button launches the app to a feature using parameters that identify the feature's location. You can use these parameters to build a URL that launches the Viewer app to a specified route.

ParameterDescription

itemUniqueIdField

The attribute in the SourceKey layer that contains a unique identifier for the feature.

Note:

This parameter is only included for features that exist in the indoor dataset. Other features, such as dropped pins, do not include a unique identifier.

itemSourceKey

The name of the layer in the web map that contains the feature, for example, Units.

itemUniqueId

The itemUniqueIdField field value for the feature.

Note:

For features that do not exist in the indoor dataset, such as dropped pins, this is randomly generated.

x

The x-coordinate of the point identifier.

y

The y-coordinate of the point identifier.

l

The vertical order of the point identifier. This is the base 0 level ordering value contained in ArcGIS Indoors Information Model feature classes.

visibleLayers

This parameter contains the operationalLayer identifier for each layer that is turned on when the web map is shared.

The URL uses these parameters to launch the Viewer app to a feature using the following structure:

https://<yourserver.yourdomain.com>/portal/apps/indoors?appid=<appid>&itemUniqueIdField=<uniqueidfield>&itemSourceKey=<itemsourcekey>&itemUniqueId=<itemuniqueid>

Note:

URLs for locations that do not exist in the indoor dataset, such as dropped pins, do not include the itemUniqueField parameter. The itemSourceKey value is set to stand-alone and an itemUniqueId value is randomly generated.

Launch to a route

You can configure the Viewer app to launch directly to a route by defining the route's start and end points in the app’s URL. If both the start and end points are provided, the app automatically resolves the route in the directions panel. Two route stops are supported: the route start and the route end.

A route must consist of a route start and a route end. You can configure these features using a structure similar to the URL generated using the Share button. To distinguish the route start from the route end in the URL, the letters rs are prefixed to each route start parameter name and the letters re are prefixed to each route end parameter name.

You can specify the unique identifier, field, and ID, or the x-, y-, and l-values to identify the feature.

Build the smart launch to route URL

You can use the Share button in Viewer to generate the route URL parameters and values.

  1. Select a feature in the Viewer app.

    The info panel appears with details for the selected feature.

  2. Click the Share button Share at the top of the info panel and click Copy to Clipboard to copy a URL to the clipboard.
  3. Paste the URL into a text editor such as Notepad++, and identify the key parameters that allow the app to launch directly to the feature.
  4. Repeat steps 1 through 3 for the other end of the route.
  5. Construct the URL to automatically launch the Viewer app to a route by doing the following:
    1. Prefix the letters rs to the parameter names for the route start feature and the letters re to the parameter names for the route end feature.
    2. Capitalize the letter immediately following the new prefix. For example, the parameter itemUniqueIdField for the route start becomes rsItemUniqueIdField, and the same parameter for the route end becomes reItemUniqueIdField.
    3. Build a smart launch URL using the following basic structure:

      https://<yourserver.yourdomain.com>/portal/apps/indoors?appid=<appid>&rsItemUniqueIdField=<routestartitemuniqueidfield>&rsItemSourceKey=<routestartitemsourcekey>&rsItemUniqueId=<routestartitemuniqueid>&reItemUniqueIdField=<routeenditemuniqueidfield>&reItemSourceKey=<routeenditemsourcekey>&reItemUniqueId=<routeenditemuniqueid>

      Note:

      For locations that do not exist in the indoor dataset, such as dropped pins, you must include the x-, y-, and l-values for the point identifier. In this case, set itemSourceKey to standalone and use the Unique item ID value from the URL generated in step 2. An itemUniqueIdField value is not required.

Example URLs

The following examples represent various URLs that can be used with a smart launch.

Launch to a feature URL

  • Shared office location:

    https://myserver.mydomain.com/portal/apps/indoors?appid=ca4618a41f074de8964eb3a04821eb9e&itemUniqueIdField=unit_id&itemSourceKey=Units&itemUniqueId=ESRI.RED.MAIN.O3w220

  • Shared dropped pin location:

    https://myserver.mydomain.com/portal/apps/indoors?appid=1a348887cb6c44ddb748cd0c65fce9db&x=-117.19555207109245&y=34.05733200897579&l=0&itemSourceKey=standalone&itemUniqueId=9fc8e6855b22471f801af991935f8d40

Launch to a route URL

  • Unit to dropped pin:

    https://myserver.mydomain.com/portal/apps/indoors/?appid=ca4618a41f074de8964eb3a04821eb9e&rsItemUniqueIdField=UNIT_ID&rsItemSourceKey=Units&rsItemUniqueId=ESRI.RED.MAIN.M1mc365&reX=-117.19672775506533&reY=34.05792177746473&reL=0&reItemSourceKey=standalone&reItemUniqueId=d9a1d2eac66d47808b23a0695fb0c565#

  • Unit to unit:

    https://myserver.mydomain.com/portal/apps/indoors/?appid=ca4618a41f074de8964eb3a04821eb9e&rsItemUniqueIdField=UNIT_ID&rsItemSourceKey=Units&rsItemUniqueId=ESRI.RED.MAIN.O3w220&reItemUniqueIdField=unit_id&reItemSourceKey=Units&reItemUniqueId=ESRI.RED.MAIN.L2e505#