Get associated utility elements

enable the modeling of connectivity, containment, and structure 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
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
// Get the elements associated with a single utility element (using containment).
ListenableFuture<List<UtilityAssociation>> utilityAssociationList =
        utilityNetwork.getAssociationsAsync(utilityElement, UtilityAssociationType.CONTAINMENT);

utilityAssociationList.addDoneListener(() -> {
    try {
        List<UtilityAssociation> utilityAssociations = utilityAssociationList.get();

        if (!utilityAssociations.isEmpty() ) {
            for (UtilityAssociation association : utilityAssociations) {
                UtilityElement fromElement = association.getFromElement();
                UtilityElement toElement = association.getToElement();
            }
        }
    } catch (InterruptedException | ExecutionException e) {
        e.printStackTrace();
    }
});

Specifying a will return all its associations unless the utility element's 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 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.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close