Get associated utility elements

Associations enable the modeling of connectivity, containment, and structure attachment between non-spatial and non-coincident network features. The following table describes the types of relationships between two utility network elements:

AssociationDescriptionGeometry supported
ConnectivityModels the connectivity between two junctions that don't have geometric coincidence (are not in the same x, y and z location). A transformer may be connected to a fuse, for example.Yes
Structural attachmentModels equipment attached to structures. A transformer bank may be attached to a pole, for example.Yes
ContainmentModels assets that contain other assets. A vault may contain valves and pipes, for example.No
Utility network associations

The following code uses an element for retrieving containment associations, and an extent for determining attachment and connectivity associations of its contents. Note that as of ArcGIS Enterprise version 10.8.1 or higher, the results of these method calls may include non-spatial associations.

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
            // Specify a utility element container
            var containments = await utilityNetwork.GetAssociationsAsync(containerElement, UtilityAssociationType.Containment);

// Get features for its contents
var contents = from containment in containments select containment.ToElement;
var contentFeatures = await utilityNetwork.GetFeaturesForElementsAsync(contents);

// Get an extent for its contents
var featureGeometries = from content in contentFeatures select content.Geometry;
var contentExtent = GeometryEngine.CombineExtents(featureGeometries);

// Specify an area of interest
var associations = await utilityNetwork.GetAssociationsAsync(contentExtent);

Specifying a utility element will return all its associations unless the utility element's terminal has been set, which limits the connectivity associations returned.

Specifying an extent will return all its connectivity or structural attachment associations with geometry. The geometry value (polyline) represents the connection relationship between a from element and a to element. You can use the geometry to visualize the association as a graphic in the map.

Samples

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