trace

AMD: require(["esri/rest/networks/trace"], (trace) => { /* code goes here */ });
ESM: import * as trace from "@arcgis/core/rest/networks/trace.js";
Object: esri/rest/networks/trace
Since: ArcGIS Maps SDK for JavaScript 4.20

Trace is the core analytic of the utility network, by providing a set of parameters, you can start the trace in one or more features and traverse the network topology satisfying the parameters until the trace stops at end points or when the definition of the trace condition barriers are met. The trace returns a collection of elements and their source, function results, diagram or aggregated geometries.

Method Overview

Name Return Type Summary Object
Promise<TraceResult>

The trace function takes a set of parameters, executes the trace analytic on the backend, and returns trace results.

trace

Method Details

trace

Method
trace(url, params, requestOptions){Promise<TraceResult>}

The trace function takes a set of parameters, executes the trace analytic on the backend, and returns trace results.

Parameters
url String

URL to the ArcGIS Server REST resource that represents a UttilityNetwork.

The list of parameters required by the trace

requestOptions RequestOptions
optional

Additional options to be used for the data request.

Returns
Type Description
Promise<TraceResult> When resolved, returns the trace results which could include elements, function results or aggregated geometries.

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