UtilityNetworkTrace

UtilityNetworkTrace

UtilityNetworkTrace runs traces on a webmap published with a utility network and trace configurations.

iPhone	iPad

Features

The utility network trace tool displays a list of named trace configurations defined for utility networks in a web map. It enables users to add starting points and perform trace analysis from the selected named trace configuration.

A named trace configuration defined for a utility network in a webmap comprises the parameters used for a utility network trace.

Key properties

UtilityNetworkTrace has the following initializer:

    /// A graphical interface to run pre-configured traces on a map's utility networks.
    /// - Parameters:
    ///   - activeDetent: The current detent of the floating panel.
    ///   - graphicsOverlay: The graphics overlay to hold generated starting point and trace graphics.
    ///   - map: The map containing the utility network(s).
    ///   - mapPoint: Acts as the point at which newly selected starting point graphics will be created.
    ///   - viewPoint: Acts as the point of identification for items tapped in the utility network.
    ///   - mapViewProxy: Provides a method of layer identification when starting points are being
    ///   chosen.
    ///   - viewpoint: Allows the utility network trace tool to update the parent map view's viewpoint.
    ///   - startingPoints: An optional list of programmatically provided starting points.
    public init(
        graphicsOverlay: Binding<GraphicsOverlay>,
        map: Map,
        mapPoint: Binding<Point?>,
        viewPoint: Binding<CGPoint?>,
        mapViewProxy: Binding<MapViewProxy?>,
        viewpoint: Binding<Viewpoint?>,
        startingPoints: Binding<[UtilityNetworkTraceStartingPoint]> = .constant([])
    )

UtilityNetworkTrace the following instance method:

    /// Sets the active detent for a hosting floating panel.
    /// - Parameter detent: A binding to a value that determines the height of a hosting
    /// floating panel.
    /// - Returns: A trace tool that automatically sets and responds to detent values to improve user
    /// experience.
    public func floatingPanelDetent(_ detent: Binding<FloatingPanelDetent>) -> UtilityNetworkTrace

Behavior:

The tool allows users to:

• Choose between multiple networks (if more than one is defined in a webmap) .
• Choose between named trace configurations:

• Add trace starting points either programmatically or by tapping on a map view, then use the inspection view to narrow the selection:

• View trace results:

iPhone	iPad

• Run multiple trace scenarios, then use color and name to compare results:

• See user-friendly warnings to help avoid common mistakes, including specifying too many starting points or running the same trace configuration multiple times.

Usage

UtilityNetworkTrace(
    graphicsOverlay: $resultGraphicsOverlay,
    map: map,
    mapPoint: $mapPoint,
    viewPoint: $viewPoint,
    mapViewProxy: $mapViewProxy,
    viewpoint: $viewpoint
)

To see the UtilityNetworkTrace in action, check out the Examples and refer to UtilityNetworkTraceExampleView.swift in the project.