Get associated utility elements

AssociationsAn association is a relationship between two elements that is reflected in a utility network topology.Learn more enable the modeling of connectivity, containment, and structure attachmentAn attachment is a file, such as a photograph (for example, a .png file) or a document, that is associated with individual features in a geodatabase or feature layer.Learn more between non-spatial and non-coincident network features. The following table describes the types of relationships between two utility network elements:

The following code uses an element for retrieving containment associations, and an extentAn extent is a bounding rectangle with points that delineate an area for a map or scene.Learn more for determining attachment and connectivity associations of its contents. Note that as of ArcGIS EnterpriseArcGIS Enterprise is a GIS mapping, analytics, data hosting, and content management product that can be hosted on-premise or in a cloud infrastructure. It includes software, applications, tools, APIs, and services for users and developers.Learn more version 10.8.1 or higher, the results of these method calls may include non-spatial associations.

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 elementA utility element is an entity in a utility network that corresponds to a feature or a part of a feature (for example, a terminal inside a device).Learn more will return all its associations unless the utility element's terminalA terminal represents logical ports, entries, or exit locations on a single device or junction object within a utility network. Each port can flow in or out. Each device can contain many terminals, all of which can be interconnected.Learn more 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 graphicA graphic is a visual element composed of a geometry, symbol, and attributes that is displayed on a map or scene.Learn more in the map.

Samples

Display utility associations

Display content of utility network container