Skip To ContentArcGIS for DevelopersSign In Dashboard


require(["esri/tasks/ClosestFacilityTask"], function(ClosestFacilityTask) { /* code goes here */ });
Class: esri/tasks/ClosestFacilityTask
Inheritance: ClosestFacilityTask Task Accessor
Since: ArcGIS API for JavaScript 4.0

Helps you find closest facilities around any location (incident) on a network.

When finding closest facilities, you can specify various parameters including how many to facilities to find and whether the direction of travel is toward or away from them. Once you've found the closest facilities, you can display the best route to or from them, return the travel cost for each route, and display directions to each facility using the ClosestFacilitySolveResult.

You can also specify a cutoff cost beyond which ArcGIS Network Analyst should not search for a facility. For instance, you can set up a closest facility problem to search for hospitals within a 15-minute drive time of the site of an accident. Any hospitals that take longer than 15 minutes to reach will not be included in the results.

Parameters for this tasks must be defined using ClosestFacilityParameters and input to the solve() method.

ClosestFacilityTask and other closest facility related classes require a "closest facility" layer. A closest facility layer is a layer of type esriNAServerClosestFacilityLayer.

See also:


new ClosestFacilityTask(properties)
properties Object

See the properties for a list of all the properties that may be passed into the constructor.

Property Overview

Any properties can be set, retrieved or listened to. See the Working with Properties topic.

The name of the class.

more details
more detailsAccessor

The options to be used for data requests.

more details
more detailsTask

The ArcGIS Server REST service URL (usually of a Feature Service Layer or Map Service Layer) for use in a task.

more details
more detailsTask

Property Details

declaredClass Stringreadonly inherited
Since: ArcGIS API for JavaScript 4.7

The name of the class. The declared class name is formatted as esri.folder.className.

requestOptions Object inherited

The options to be used for data requests. These options can also be controlled through the requestOptions method parameter.

The ArcGIS Server REST service URL (usually of a Feature Service Layer or Map Service Layer) for use in a task.

Method Overview

NameReturn TypeSummaryClass

Solves the closest facility.

more details
more detailsClosestFacilityTask

Method Details

solve(params, requestOptions){Promise<ClosestFacilitySolveResult>}

Solves the closest facility.


Defines the parameters of the closest facility analysis.

requestOptions Object

Additional options to be used for the data request (will override requestOptions defined during construction).

Promise<ClosestFacilitySolveResult>When resolved, returns an instance of ClosestFacilitySolveResult
  // Do something with the solveResults here

API Reference search results