Utility network

You can add the following utility network capabilities to your app:

  • Display a utility network (section below)—Visualize assets on a map and see how assets are connected.
  • Trace how resources (gas, water, electricity, and so on) flow through a utility system network. For details, see the Trace a utility network topic. To perform traces, your app must be licensed with a Utility Network extension license.
  • Get associated utility elements. Associations let you model connectivity between points that are not coincident, the structural support of assets, and features encased within other features. For details, see the Get associated utility elements section in the Trace a utility network topic.

To create, edit, manage, and configure a utility network, use ArcGIS Pro. Create it within an enterprise geodatabase, configure it, and publish it as a feature service so that it can be used in your app. For more information on creating utility networks, see in the utility network creation and configuration in the ArcGIS Pro documentation.

Every utility network contains at least one domain network and may contain tiers, subnetworks, and subnetwork controllers. The properties of these components define the characteristics of the subnetworks and drive tracing operations. In your app, you can access schema information about these components from a utility network definition object.

For more information about utility networks, see What is a utility network? in ArcGIS Pro's help.

For information about the logical structure of a utility network, see Structure of a utility network in ArcGIS Pro's help. Note that feature classes in ArcGIS Pro are similar to feature tables in this API.

Display a utility network

You can display and share a complete utility network using a web map. You should include at most one feature layer for every feature table in the utility network.

As an alternative to using a web map, you can create your own map programmatically, making use of subtype feature layers (known as subtype group layers in ArcGIS Pro and in the web map). Subtype feature layers allow symbology and other layer properties to be set on a per-subtype basis. Utility networks make extensive use of subtypes (referred to as asset groups within a utility network). For example, a device feature table from an electric utility network would include subtypes for fuses, switches, transformers, and other kinds of equipment.

You can use display filters to show and hide features inside containers, replicating the functionality available in ArcGIS Pro to show or hide containment association content. You can also use display filters to ensure that critical network features are returned in a trace result even if they are removed from view to simplify the display. For more information, see display filters in feature layers.

Take a utility network offline

Starting with version 100.11.0, you can take certain utility network information offline. Associations, which are used to describe containment, structural attachment, and connection between features with non-coincident geometry, can be queried and displayed with offline data. Simple edits can also be made to utility network features while offline, and synchronized back to ArcGIS Enterprise.


Configure subnetwork trace

Trace utility network

Perform valve isolation trace

Display utility associations

Display subtype feature layer

Display content of utility network container

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.