Display utility associations

View in

Android

Forms

UWP

WPF

WinUI

iOS

View on GitHub

Create graphics for utility associations in a utility network.

Image of display utility associations

Use case

Visualizing utility associations can help you to better understand trace results and the topology of your utility network. For example, connectivity associations allow you to model connectivity between two junctions that don't have geometric coincidence (are not in the same location); structural attachment associations allow you to model equipment that may be attached to structures; and containment associations allow you to model features contained within other features.

How to use the sample

Pan and zoom around the map. Observe graphics that show utility associations between junctions.

How it works

Create and load a UtilityNetwork with a feature service URL.
Add a FeatureLayer to the map for every UtilityNetworkSource of type Edge or Junction.
Create a GraphicsOverlay for the utility associations.
Add an event handler for the ViewpointChanged event of the MapView.
When the sample starts and every time the viewpoint changes, do the following steps.
Get the geometry of the mapview's extent using GetCurrentViewpoint(ViewpointType.BoundingGeometry)?.TargetGeometry?.Extent.
Get the associations that are within the current extent using GetAssociationsAsync(extent).
Get the UtilityAssociationType for each association.
Create a Graphic using the Geometry property of the association and a preferred symbol.
Add the graphic to the graphics overlay.

Relevant API

GraphicsOverlay
UtilityAssociation
UtilityAssociationType
UtilityNetwork

About the data

The feature service in this sample represents an electric network in Naperville, Illinois, which contains a utility network used to run the subnetwork-based trace.

Additional information

Using utility network on ArcGIS Enterprise 10.8 requires an ArcGIS Enterprise member account licensed with the Utility Network user type extension. Please refer to the utility network services documentation.

Sample Code

DisplayUtilityAssociations.xaml

DisplayUtilityAssociations.xaml.cs

Use dark colors for code blocksCopy
﻿<ContentPage x:Class="ArcGISRuntimeXamarin.Samples.DisplayUtilityAssociations.DisplayUtilityAssociations"
             xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:esriUI="clr-namespace:Esri.ArcGISRuntime.Xamarin.Forms;assembly=Esri.ArcGISRuntime.Xamarin.Forms"
             xmlns:resources="clr-namespace:Forms.Resources">
    <RelativeLayout>
        <esriUI:MapView x:Name="MyMapView"
                        BindingContext="{x:Reference Name=ResponsiveFormContainer}"
                        NavigationCompleted="OnNavigationCompleted"
                        Style="{StaticResource MapWithFormStyle}" />
        <resources:ResponsiveFormContainer x:Name="ResponsiveFormContainer">
            <Grid>
                <Grid.RowDefinitions>
                    <RowDefinition Height="auto" />
                    <RowDefinition Height="auto" />
                </Grid.RowDefinitions>
                <Grid.ColumnDefinitions>
                    <ColumnDefinition Width="auto" />
                    <ColumnDefinition Width="*" />
                </Grid.ColumnDefinitions>
                <Label Grid.Row="0"
                       Grid.Column="1"
                       Text="Attachment" />
                <Label Grid.Row="1"
                       Grid.Column="1"
                       Text="Connectivity" />
                <Image x:Name="AttachmentImage"
                       Grid.Row="0"
                       Grid.Column="0"
                       WidthRequest="25" />
                <Image x:Name="ConnectivityImage"
                       Grid.Row="1"
                       Grid.Column="0"
                       WidthRequest="25" />
            </Grid>
        </resources:ResponsiveFormContainer>
    </RelativeLayout>
</ContentPage>