Prepare a map for Indoor Viewer

Available for an ArcGIS organization licensed with the Indoors extension.

The Indoor Viewer app is configured to use a web map that contains either map image layers or feature layers. Maps that support Indoors, whether map image layers, feature layers, or mobile map packages, have layer requirements for feature classes in the Indoors geodatabase to support the apps and their functionality. These layers must conform to the ArcGIS Indoors Information Model, and are created and curated using ArcGIS Pro.

Before you prepare a map and share it to your ArcGIS organization for use in the Viewer app, you must create Indoors data that conforms to the Indoors model. This includes creating an Indoors database, loading data into the database, and optionally creating an indoor routable network in ArcGIS Pro.

Required data layers

The following layers are required for indoor data visualization in Indoor Viewer:

  • Details
  • Units
  • Levels
  • Facilities
    Note:

    This layer must be drawn on top of other indoor map layers to facilitate the 2D campus navigation experience in Viewer.

Include the following layers to support indoor routing and directions:

  • Network_ND
  • Pathways
  • Transitions

Include the following layers to support additional functionality in Viewer:

  • Events—List events and locate them on the map
  • Occupants—Search for occupants, find them on the map, and configure workspace reservations
  • <Category source> layers—Search and explore for additional features that you configure as categories
  • <Barrier> layers—Use in routing when there are temporary changes to the network
  • <Work order> layers—Integrate work orders
  • Reservations layer—Configure workspace reservations
  • Sites—Organize facility features by the site in which they are located

Optionally include the following tables to support workspace reservations:

  • Areas—If you are using the Indoor Space Planner app to assign occupants to spaces, include the Areas table. This is necessary for displaying occupant's hotel assignments in the info panel.
  • Area Roles—Required if you are configuring reservation managers who can book hotels and manage bookings for other people.
    Note:

    This capability is available in ArcGIS Online. It will be available in a future release of ArcGIS Enterprise.

Note:

Layer names included in the indoor web map must exactly match these layer names to enable functionality in the Indoors web apps.

You can configure additional features that you want to interact with in the Viewer app as categories using the Create Indoors Category or Create Default Indoors Categories tools. These features can be from point or polygon layers in a floor-aware map and require a level ID field that matches the LEVEL_ID field value of the associated feature in the Levels feature class.

The number of related items that are displayed for a feature in the info panel in Viewer is limited to the maximum number of features per layer. You can set this amount using the Maximum records returned by server parameter. This is important when displaying related items for a large feature such as a building.

Prepare the map

After creating your indoor data and optionally configuring categories, launch actions, or a routable network, you can create a map to share to your ArcGIS organization for use in Viewer. The Viewer web map needs to contain all of the required map image layers and feature layers.

Note:

When creating your indoor data, you can use an Indoors geodatabase (created using the Create Indoors Database tool) or an indoor dataset (created using the Create Indoor Dataset tool).

An Indoors geodatabase contains all the required attributes and tables for mapping floor plans, space planning, routing, and workspace reservations, while the indoor dataset includes a simplified schema that is best suited for basic floor plan mapping.

Complete these steps to create a map and prepare it for use by Indoor Viewer:

  1. Start ArcGIS Pro.
  2. Sign in to your ArcGIS organization.
  3. Create a project and add a connection to your Indoors geodatabase or open an existing project that contains your Indoors geodatabase.
  4. If necessary, click the Insert tab and click the New Map button New Map to create a map.
  5. Add the following layers to the map and set the visibility as follows:

    Layer nameRequiredLayer visibility (recommended)

    Facilities

    Yes

    On

    Note:

    The Facilities layer is particularly important in Viewer. Its position in the table of contents, visibility, and symbology determines the visibility of other layers in the map. To show the floor plans of all buildings, you can turn off the visibility or set the transparency on the Facilities layer. In this scenario, the ground floor of all unselected buildings is shown on the map at all times. The visible level in the selected building is set by the floor picker. If layers are drawn below the Facilities layer in the table of contents, only the features on the currently visible levels are shown. If layers are drawn above the Facilities layer, they are shown for all levels on unselected buildings.

    Events

    No

    Off

    Occupants

    No

    Off

    <Category source> layers

    No

    Off

    Details

    No

    On

    Units

    No

    On

    Levels

    Yes

    On

    Keep the following in mind when adding and configuring layers:

    • If you want to be able to identify features in the app, but don't need the explore or search experience and don't need to route to them, add these features to the map as basic layers (points, lines, polygons, or multipatch 3D features). You also must configure pop-ups for them in a later step.
    • Indoor Viewer supports adding feature layers to the web map. Customization to display name, symbology, or other layer properties made in ArcGIS Pro for work order layers in Indoor Viewer is not available to mobile users. If you are using a feature layer for work orders that requires customization in both Indoor Viewer and mobile apps, consider making these changes in the shared layer so that users of the web and mobile apps have a similar experience.
    • You can include optional tables in your map at this time:
      • If you are using the Indoor Space Planner app to assign occupants to spaces, include the Areas table. This is necessary for displaying occupant's hotel or hot desk assignments in the info panel.
      • If you are using ArcGIS Online and assigned reservation managers inSpace Planner, include the Area Roles table.
  6. Configure the map as floor aware.

    Maps that aren't floor aware are not supported in the Viewer app for ArcGIS Online. They will not be supported at ArcGIS Enterprise 11 and later.

  7. Configure additional layers as floor aware.
  8. If you're using the Reservation layer method to configure office hotels and meeting rooms, add the Reservations feature class to the map.
  9. Set the visible scale range of the layers as necessary.
  10. Set the symbology properties of the layers as follows:

    Details and Units layers

    Set according to the USE_TYPE attribute.

    <Category source> layers

    Set according to the field that describes the feature type.

    Occupants and Events layers

    Use an empty point symbol (no color or outline, and size 1).

    Note:

    Use caution when applying symbols for category layers that have dense coverage. For example, offices are symbolized by the color of the unit polygon and shouldn't have individual point symbols.

  11. Turn on labeling for Units (NAME attribute), Occupants (KNOWNAS attribute), and any additional features that require a label.

    You can configure labels so that occupied office units display the occupant's name and unoccupied offices display the unit's name to visually identify which offices are vacant or available to assign in the app. To hide the unit name label for occupied offices, configure labels for the units layer as follows:

    1. Right-click the Units layer in the Contents pane and click Labeling Properties.

      The Label Class pane appears.

    2. Click the SQL query button SQL Query and click New expression.
    3. Create the following expression:
      Where Assignment Type is not equal to office
    4. Click Apply.

    Occupant labels may overlap with labels for adjacent units, which results in missing labels in the app. To avoid overlapping labels, you can stack occupant labels using an Arcade expression by completing the following:

    1. Right-click the Occupants layer in the Contents pane and click Labeling Properties.

      The Label Class pane appears.

    2. Click the Label expression button Label expression and create the following Arcade expression:
      Replace($feature.KNOWNAS, ' ', TextFormatting.NewLine)
    3. Click Apply.
  12. Set the display field in the layer properties for Occupants, if present, to KNOWNAS and all other map layers to NAME.
    Note:

    The Viewer app uses the display field value for labeling certain items in the app, such as the info panel title. Setting this in ArcGIS Pro now will help avoid confusion for app users.

  13. Configure pop-ups for any additional layers you may want to identify on the map.

    Configure pop-ups for layers that you want to interact with on the map in Viewer. These basic layers don't support the explore or search experience, and action buttons, such as Directions, are not available.

  14. Ensure that the map has a coordinate system set for Current XY, such as WGS 1984 Web Mercator (Auxiliary Sphere), and Current Z, such as WGS84.
  15. Optionally, rename the map to make it easily identifiable, and complete all metadata fields.
  16. Set the display extent of the map to display all of the map data.
  17. If enabled, disable the range slider or floor filter in the map.
    Caution:

    This is important. An enabled range slider can prevent data from being shared to Indoors web apps.

  18. Add any Esri-hosted or custom basemap services to the map.
    Note:

    Configure a basemap to choose between an Esri-hosted basemap or a custom vector tile package basemap.

  19. Clear all feature selections.

    You can now configure and share the web map for use in Space Planner. This includes first sharing a branch versioned feature layer that includes the Units and Occupants feature classes and the Areas table, updating the data source for these items in your map in ArcGIS Pro, and then sharing the web map for use in Space Planner.

The map is now ready to publish and share as a web map to your ArcGIS organization.

You can further configure the map in ArcGIS Pro to configure a basemap, publish category features as a feature layer, or enable additional app functionalities such as searchable events, work orders, device location and tracking, hotel booking, app launch actions, and routing barriers. You can also use the Viewer map to create a 3D scene in ArcGIS Pro for use in the Viewer app.

Configure a basemap

A basemap is an important part of an indoor map that provides context and perspective for what's nearby. Keep in mind the scale of your map when choosing the basemap to use. Unlike image tile basemaps, vector tile basemaps are smaller and support higher levels of detail.

Depending on your organization's needs, you can use one of the online basemap services hosted by Esri or author a custom basemap. The following sections provide the necessary steps to configure a basemap for Indoors.

Use an Esri-hosted basemap

In ArcGIS Pro, you can add basemaps from the Basemap gallery in the Layer group on the Map tab. Depending on how your active portal is configured, the gallery can include the default Esri basemaps, maps shared to your organization's basemap gallery group, and basemaps you added to a project in ArcGIS Pro.

You can also add Esri vector basemaps to a map by completing the following steps:

  1. Copy the URL for the vector basemap you want to add.
  2. Click the Add Data drop-down arrow in the Layer group.
  3. Choose the Data From Path option.

    The Add Data From Path dialog box appears.

  4. Paste the URL.
  5. Click Add.

Use a custom basemap hosted on an Enterprise portal

To use a custom basemap hosted on your Enterprise portal, complete these steps:

  1. Author a custom basemap.
  2. Create a vector tile package using the Create Vector Tile Package tool.

    When you run the Create Vector Tile Package tool, make the following adjustments to provide support for an indoor level of detail and scale the tile down by a factor of 17:

    1. Uncheck the Package for ArcGIS Online | Bing Maps | Google Maps check box.
    2. Choose the VectorBasemapTilingScheme.xml file included in the Indoors symbology resources for the Tiling scheme parameter.
  3. Share the vector tile package to your Enterprise portal.
  4. Sign in to your Enterprise portal in a browser and publish the vector tile package as a hosted layer.
  5. Add the Enterprise portal items to the map in ArcGIS Pro.
    Tip:

    Alternatively, if you have the hosted tile layer URL, you can copy it onto the Add Data From Path dialog box by clicking the Add Data drop-down arrow in the Layer group and choosing Data From Path.