ClosestFacilityParameters | API Reference | ArcGIS Maps SDK for JavaScript 4.32

ClosestFacilityParameters provides the input parameters for a closestFacility request.

See also

Constructors

ClosestFacilityParameters Constructor new ClosestFacilityParameters(properties)

Parameter

properties Object

optional

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 Watch for changes topic.

Show inherited properties

Hide inherited properties

Type	Summary	Class
String []\|null\|undefined	Use this property to specify whether the operation should accumulate values other than the value specified for impedanceAttribute.	ClosestFacilityParameters
String\|null\|undefined	An authorization string used to access a resource or service.	ClosestFacilityParameters
AttributeParameterValue []\|null\|undefined	Use this property to specify additional values required by an attribute or restriction, such as to specify whether the restriction prohibits, avoids, or prefers travel on restricted roads.	ClosestFacilityParameters
String	The name of the class.	Accessor
Number\|null\|undefined	The travel time or travel distance value at which to stop searching for facilities for a given incident.	ClosestFacilityParameters
Number\|null\|undefined	The number of closest facilities to find per incident.	ClosestFacilityParameters
String\|null\|undefined	The language that will be used when generating travel directions.	ClosestFacilityParameters
LengthUnit\|String\|null\|undefined	Specify the units for displaying travel distance in the driving directions.	ClosestFacilityParameters
String\|null\|undefined	Define the content and verbosity of the driving directions.	ClosestFacilityParameters
String\|null\|undefined	Specify the name of the formatting style for the directions.	ClosestFacilityParameters
String\|null\|undefined	Set the time-based impedance attribute to display the duration of a maneuver, such as "Go northwest on Alvorado St.	ClosestFacilityParameters
DataLayer\|FeatureSet\|NetworkFeatureSet\|NetworkUrl\|null\|undefined	One or more locations that are searched for when finding the closest location.	ClosestFacilityParameters
Number\|null\|undefined	Use this property to specify the number of decimal places in the response geometries returned by solve operation.	ClosestFacilityParameters
Number\|null\|undefined	Use this property to specify the number of decimal places in the response geometries returned by solve operation.	ClosestFacilityParameters
Number\|null\|undefined	Use this property to specify the number of decimal places in the response geometries returned by a solve operation.	ClosestFacilityParameters
Boolean\|null\|undefined	Specify whether invalid input locations should be ignored when finding the best solution.	ClosestFacilityParameters
String\|null\|undefined	Specifies the impedance.	ClosestFacilityParameters
DataLayer\|FeatureSet\|NetworkFeatureSet\|NetworkUrl\|null\|undefined	One or more locations from which the service searches for the nearby locations	ClosestFacilityParameters
SpatialReference\|null\|undefined	Use this property to specify the spatial reference of the geometries, such as line or point features, returned by a solve operation.	ClosestFacilityParameters
Number\|null\|undefined	Use this property to specify by how much you want to simplify the route geometry returned by the operation.	ClosestFacilityParameters
LengthUnit\|String\|null\|undefined	Use this property to specify the units for the value specified for the outputGeometryPrecision parameter.	ClosestFacilityParameters
String\|null\|undefined	Use this property to specify the type of route features that are output by the operation.	ClosestFacilityParameters
Object\|null\|undefined	Specify additional settings that can influence the behavior of the solver when finding solutions for the network analysis problems.	ClosestFacilityParameters
Collection<PointBarrier>\|DataLayer\|FeatureSet\|NetworkFeatureSet\|NetworkUrl\|null\|undefined	Use this property to specify one or more points that will act as temporary restrictions or represent additional time or distance that may be required to travel on the underlying streets.	ClosestFacilityParameters
Collection<PolygonBarrier>\|DataLayer\|FeatureSet\|NetworkFeatureSet\|NetworkUrl\|null\|undefined	Use this property to specify polygons that either completely restrict travel or proportionately scale the time or distance required to travel on the streets intersected by the polygons.	ClosestFacilityParameters
Collection<PolylineBarrier>\|DataLayer\|FeatureSet\|NetworkFeatureSet\|NetworkUrl\|null\|undefined	Use this property to specify one or more lines that prohibit travel anywhere the lines intersect the streets.	ClosestFacilityParameters
Boolean\|null\|undefined	Use this property to specify if the Object IDs specified for input locations such as stops or barriers should be preserved when the input locations are returned as output.	ClosestFacilityParameters
String\|null\|undefined	Specifies how U-Turns should be handled.	ClosestFacilityParameters
String []\|null\|undefined	Use this property to specify which restrictions should be honored by the operation.	ClosestFacilityParameters
Boolean\|null\|undefined	Specify whether the operation should generate driving directions for each route.	ClosestFacilityParameters
Boolean\|null\|undefined	Determines if facilities will be returned by the service.	ClosestFacilityParameters
Boolean\|null\|undefined	Determines if incidents will be returned by the service.	ClosestFacilityParameters
Boolean\|null\|undefined	Specify whether point barriers will be returned by the routing operation.	ClosestFacilityParameters
Boolean\|null\|undefined	Specify whether polygon barriers will be returned by the routing operation.	ClosestFacilityParameters
Boolean\|null\|undefined	Specify whether polyline barriers will be returned by the routing operation.	ClosestFacilityParameters
Boolean\|null\|undefined	Use this property to specify if the operation should return routes.	ClosestFacilityParameters
Boolean\|null\|undefined	Specify whether traversed edges will be returned by the operation.	ClosestFacilityParameters
Boolean\|null\|undefined	Specify whether traversed junctions will be returned by the operation.	ClosestFacilityParameters
Boolean\|null\|undefined	Specify whether traversed turns will be returned by the operation.	ClosestFacilityParameters
Boolean\|null\|undefined	Include z values for the returned geometries if supported by the underlying network.	ClosestFacilityParameters
Date\|String\|null\|undefined	Specify the time and date to depart from or arrive at incidents or facilities.	ClosestFacilityParameters
Boolean\|null\|undefined	Specify the time zone or zones of the timeOfDay property.	ClosestFacilityParameters
String\|null\|undefined	The timeOfDay parameter value represents the arrival or departure time for the routes.	ClosestFacilityParameters
String\|null\|undefined	Specifies how the travel direction for the closest facility search will be measured.	ClosestFacilityParameters
TravelMode\|null\|undefined	A travel mode represents a means of transportation, such as driving or walking.	ClosestFacilityParameters
Boolean\|null\|undefined	Specify whether hierarchy should be used when finding the shortest paths.	ClosestFacilityParameters

Property Details

accumulateAttributes Property accumulateAttributes String[] |null |undefined

Use this property to specify whether the operation should accumulate values other than the value specified for impedanceAttribute. For example, if your impedanceAttribute is set to travel-time, the total travel time for the route will be calculated by the operation. However, if you also want to calculate the total distance of the route in miles, you can specify Miles as the value for the accumulateAttributes property.

Known Value
kilometers
miles
meters
minutes
time-at-1kph
travel-time
truck-minutes
truck-travel-time
walk-time

See also

apiKey Property apiKey String |null |undefined Since: ArcGIS Maps SDK for JavaScript 4.21 ClosestFacilityParameters since 4.20, apiKey added at 4.21.

An authorization string used to access a resource or service. API keys are generated and managed in the portal. An API key is tied explicitly to an ArcGIS account; it is also used to monitor service usage. Setting a fine-grained API key on a specific class overrides the global API key.

See also

Example

const start = new Graphic({
  geometry: {
    type: "point",
    x: -13656212.041436872,
    y: 5703897.952531632,
    spatialReference
  }
});

const stores = [
  [-122.67484, 45.52087],
  [-122.68365, 45.52327],
  [-122.66406, 45.52378]
];

const storeGraphics = stores.map(
  (store) =>
    new Graphic({
      geometry: {
        type: "point",
        longitude: store[0],
        latitude: store[1],
        spatialReference
      }
    })
);

const closestFacilityParameters = new ClosestFacilityParameters({
  apiKey: "YOUR_API_KEY",
  incidents: new FeatureSet({
    features: [start]
  }),
  facilities: new FeatureSet({
    features: storeGraphics
  }),
  defaultTargetFacilityCount: 2
});

const results = await solve(url, closestFacilityParameters);

attributeParameterValues Property attributeParameterValues AttributeParameterValue[] |null |undefined

Use this property to specify additional values required by an attribute or restriction, such as to specify whether the restriction prohibits, avoids, or prefers travel on restricted roads. If the restriction is meant to avoid or prefer roads, you can further specify the degree to which they are avoided or preferred using this property. For example, you can choose to never use toll roads, avoid them as much as possible, or prefer them.

See also

attributeParameterValues

declaredClass Inherited Property declaredClass Stringreadonly Inherited from Accessor

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

defaultCutoff Property defaultCutoff Number |null |undefined

The travel time or travel distance value at which to stop searching for facilities for a given incident. For example, while finding the closest hospitals from the site of an accident, a cutoff value of 15 minutes means that the tool will search for the closest hospital within 15 minutes from the incident. If the closest hospital is 17 minutes away, no routes will be returned in the output routes. A cutoff value is especially useful when searching for multiple facilities.

The unit for this parameter is based on the unit of the impedance attribute specified using the impedanceAttributeName parameter or the impedanceAttributeName of the travel mode if travel mode is specified . If the impedanceAttributeName parameter is TravelTime, the defaultCutoff is specified in minutes. Otherwise, the value is specified in miles or kilometers based on whether the impedanceAttributeName is set to Miles or Kilometers, respectively.

See also

defaultCutoff

defaultTargetFacilityCount Property defaultTargetFacilityCount Number |null |undefined

The number of closest facilities to find per incident. This is useful in situations in which multiple fire engines may be required from different fire stations, such as a fire. You can specify, for example, to find the three nearest fire stations to a fire.

The value for this parameter can be overridden on a per incident basis by specifying a value for the TargetFacilityCount attribute when specifying the incidents parameter.

See also

defaultTargetFacilityCount

directionsLanguage Property directionsLanguage String |null |undefined

The language that will be used when generating travel directions. This parameter applies only when the returnDirections parameter is set to true. The service supports generating directions in the following languages: ar, bg, bs, ca, cs, da, de, el, en, es, et, fi, fr, he, hr, hu, id, it, ja, ko, lt, lv, nb, nl, pl, pt-BR, pt-PT, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh-CN, zh-HK and zh-TW.

See also

directionsLanguage

directionsLengthUnits Property directionsLengthUnits LengthUnit |String |null |undefined

Specify the units for displaying travel distance in the driving directions. This parameter applies only when the returnDirections parameter is set to true.

Possible Values:"decimal-degrees" |"points" |"unknown"

See also

directionsLengthUnits

directionsOutputType Property directionsOutputType String |null |undefined

Define the content and verbosity of the driving directions. This parameter applies only when the returnDirections parameter is set to true.

See also

directionsOutputType

directionsStyleName Property directionsStyleName String |null |undefined

Specify the name of the formatting style for the directions.

Possible Values:"desktop" |"navigation" |"campus"

See also

directionsStyleName

directionsTimeAttribute Property directionsTimeAttribute String |null |undefined

Set the time-based impedance attribute to display the duration of a maneuver, such as "Go northwest on Alvorado St. for 5 minutes." The units for all the time attributes is minutes.

Known Value
minutes
time-at-1-kph
travel-time
truck-minutes
truck-travel-time
walk-time

Possible Values:"travel-time" |"truck-travel-time" |"walk-time" |"minutes" |"truck-time"

See also

directionsTimeAttributeName

One or more locations that are searched for when finding the closest location.

See also

facilities

Example

const closestFacilityParameters = new ClosestFacilityParameters({
  facilities: new FeatureSet({
    features: [
      new Graphic({
        geometry: new Point({ x: -122.4079, 37.78356 }),
        attributes: {
          "Name": "Fire Station 34",
          "Attr_TravelTime": 4
        }
      }),
      new Graphic({
        geometry: new Point({ x: -122.404, 37.782 }),
        attributes: {
          "Name": "Fire Station 29",
          "Attr_TravelTime": 5
        }
      })
    ]
  })
});

geometryPrecision Property geometryPrecision Number |null |undefined Since: ArcGIS Maps SDK for JavaScript 4.25 ClosestFacilityParameters since 4.20, geometryPrecision added at 4.25.

Use this property to specify the number of decimal places in the response geometries returned by solve operation. This applies to x- and y-values only (not m- or z-values).

See also

geometryPrecision

geometryPrecisionM Property geometryPrecisionM Number |null |undefined Since: ArcGIS Maps SDK for JavaScript 4.25 ClosestFacilityParameters since 4.20, geometryPrecisionM added at 4.25.

Use this property to specify the number of decimal places in the response geometries returned by solve operation. This applies to m-value only (not x-,y- or z-values).

See also

geometryPrecisionM

geometryPrecisionZ Property geometryPrecisionZ Number |null |undefined Since: ArcGIS Maps SDK for JavaScript 4.25 ClosestFacilityParameters since 4.20, geometryPrecisionZ added at 4.25.

Use this property to specify the number of decimal places in the response geometries returned by a solve operation. This applies to z-value only (not x-,y- or m-values).

See also

geometryPrecisionZ

ignoreInvalidLocations Property ignoreInvalidLocations Boolean |null |undefined Since: ArcGIS Maps SDK for JavaScript 4.25 ClosestFacilityParameters since 4.20, ignoreInvalidLocations added at 4.25.

Specify whether invalid input locations should be ignored when finding the best solution. An input point is deemed invalid by the operation if it is not within the maximum snap tolerance of any traversable street. When true invalid points are ignored. When false any invalid point in your request will cause the operation to return a failure.

See also

ignoreInvalidLocations

impedanceAttribute Property impedanceAttribute String |null |undefined

Specifies the impedance.

Impedance is a value that quantifies travel along the transportation network. Travel distance is an example of impedance; it quantifies the length of walkways and road segments. Similarly, drive time—the typical time it takes to drive a car along a road segment—is an example of impedance. This property will be ignored if travelMode is set.

Known Value
kilometers
miles
meters
minutes
time-at-1kph
travel-time
truck-minutes
truck-travel-time
walk-time

See also

One or more locations from which the service searches for the nearby locations

See also

incidents

Example

const closestFacilityParameters = new ClosestFacilityParameters({
  incidents: new FeatureSet({
    features: [
      new Graphic({
        geometry: new Point({ x: -122.4079, 37.78356 }),
        attributes: {
          "Name": "Fire Incident 1",
          "Attr_TravelTime": 4
        }
      }),
      new Graphic({
        geometry: new Point({ x: -122.404, 37.782 }),
        attributes: {
          "Name": "Crime Incident 45",
          "Attr_TravelTime": 5
        }
      })
    ]
  })
});

outSpatialReference Property outSpatialReference SpatialReference |null |undefinedautocast

Use this property to specify the spatial reference of the geometries, such as line or point features, returned by a solve operation.

See also

outSR

outputGeometryPrecision Property outputGeometryPrecision Number |null |undefined

Use this property to specify by how much you want to simplify the route geometry returned by the operation. Simplification maintains critical points on a route, such as turns at intersections, to define the essential shape of the route and removes other points. The value of this property, regardless of whether you rely on the default or explicitly set a value, is overridden when you pass in travelMode.

The units are specified with the outputGeometryPrecisionUnits parameter.

See also

outputGeometryPrecision

outputGeometryPrecisionUnits Property outputGeometryPrecisionUnits LengthUnit |String |null |undefined

Use this property to specify the units for the value specified for the outputGeometryPrecision parameter. The value of this parameter, regardless of whether you rely on the default or explicitly set a value, is overridden when you pass in travelMode.

Possible Values:"decimal-degrees" |"points" |"unknown"

See also

outputGeometryPrecisionUnits

outputLines Property outputLines String |null |undefined

Use this property to specify the type of route features that are output by the operation. This parameter is applicable only if the returnRoutes parameter is set to true.

Possible Value	Description
none	Do not return any shapes for the routes.
straight	Return a straight line between the stops.
true-shape	Return the exact shape of the resulting route that is based on the underlying streets.
true-shape-with-measure	Return the exact shape of the resulting route that is based on the underlying streets and include route measurements that keep track of the cumulative travel time or travel distance along the route relative to the first stop.

Possible Values:"none" |"straight" |"true-shape" |"true-shape-with-measure"

See also

outputLines

overrides Property overrides Object |null |undefined Since: ArcGIS Maps SDK for JavaScript 4.25 ClosestFacilityParameters since 4.20, overrides added at 4.25.

Specify additional settings that can influence the behavior of the solver when finding solutions for the network analysis problems.

See also

overrides

Use this property to specify one or more points that will act as temporary restrictions or represent additional time or distance that may be required to travel on the underlying streets. For example, a point barrier can be used to represent a fallen tree along a street or a time delay spent at a railroad crossing.

See also

barriers

Use this property to specify polygons that either completely restrict travel or proportionately scale the time or distance required to travel on the streets intersected by the polygons.

See also

polygonBarriers

Use this property to specify one or more lines that prohibit travel anywhere the lines intersect the streets. For example, a parade or protest that blocks traffic across several street segments can be modeled with a line barrier.

See also

polylineBarriers

preserveObjectID Property preserveObjectID Boolean |null |undefined Since: ArcGIS Maps SDK for JavaScript 4.25 ClosestFacilityParameters since 4.20, preserveObjectID added at 4.25.

Use this property to specify if the Object IDs specified for input locations such as stops or barriers should be preserved when the input locations are returned as output.

See also

preserveObjectID

restrictUTurns Property restrictUTurns String |null |undefined

Specifies how U-Turns should be handled.

Possible Value	Description
allow-backtrack	U-turns are permitted everywhere. Allowing U-turns implies that the vehicle can turn around at a junction and double back on the same street.
at-dead-ends-only	U-turns are prohibited at all junctions and intersections and are permitted only at dead ends.
no-backtrack	U-turns are prohibited at all junctions, intersections, and dead-ends.
at-dead-ends-and-intersections	U-turns are prohibited at junctions where exactly two adjacent streets meet.

Possible Values:"allow-backtrack" |"at-dead-ends-only" |"no-backtrack" |"at-dead-ends-and-intersections"

See also

restrictUTurns

restrictionAttributes Property restrictionAttributes String[] |null |undefined

Use this property to specify which restrictions should be honored by the operation. A restriction represents a driving preference or requirement. This value is ignored if travelMode is specified.

Known Value
any-hazmat-prohibited
avoid-carpool-roads
avoid-express-lanes
avoid-ferries
avoid-gates
avoid-limited-access-roads
avoid-private-roads
avoid-roads-unsuitable-for-pedestrians
avoid-stairways
avoid-toll-roads
avoid-toll-roads-for-trucks
avoid-truck-restricted-roads
avoid-unpaved-roads
axle-count-restriction
driving-a-bus
driving-a-taxi
driving-a-truck
driving-an-automobile
driving-an-emergency-vehicle
height-restriction
kingpin-to-rear-axle-length-restriction
length-restriction
preferred-for-pedestrians
riding-a-motorcycle
roads-under-construction-prohibited
semi-or-tractor-with-one-or-more-trailers-prohibited
single-axle-vehicles-prohibited
tandem-axle-vehicles-prohibited
through-traffic-prohibited
truck-with-trailers-restriction
use-preferred-hazmat-routes
use-preferred-truck-routes
walking
weight-restriction

See also

restrictionAttributeNames

returnDirections Property returnDirections Boolean |null |undefined

Specify whether the operation should generate driving directions for each route. If true directions are configured based on the values for the directionsLanguage, directionsOutputType, directionsStyleName, and directionsLengthUnits properties.

Default Value:false

See also

returnDirections

returnFacilities Property returnFacilities Boolean |null |undefined

Determines if facilities will be returned by the service.

Default Value:false

See also

returnFacilities

returnIncidents Property returnIncidents Boolean |null |undefined

Determines if incidents will be returned by the service.

Default Value:false

See also

returnIncidents

returnPointBarriers Property returnPointBarriers Boolean |null |undefined

Specify whether point barriers will be returned by the routing operation.

Default Value:false

See also

returnBarriers

returnPolygonBarriers Property returnPolygonBarriers Boolean |null |undefined

Specify whether polygon barriers will be returned by the routing operation.

Default Value:false

See also

returnPolygonBarriers

returnPolylineBarriers Property returnPolylineBarriers Boolean |null |undefined

Specify whether polyline barriers will be returned by the routing operation.

Default Value:false

See also

returnPolylineBarriers

returnRoutes Property returnRoutes Boolean |null |undefined

Use this property to specify if the operation should return routes. If true, the shape of the routes depends on the value for the outputLines property.

Default Value:true

See also

returnCFRoutes

returnTraversedEdges Property returnTraversedEdges Boolean |null |undefined Since: ArcGIS Maps SDK for JavaScript 4.25 ClosestFacilityParameters since 4.20, returnTraversedEdges added at 4.25.

Specify whether traversed edges will be returned by the operation.

See also

returnTraversedEdges

returnTraversedJunctions Property returnTraversedJunctions Boolean |null |undefined Since: ArcGIS Maps SDK for JavaScript 4.25 ClosestFacilityParameters since 4.20, returnTraversedJunctions added at 4.25.

Specify whether traversed junctions will be returned by the operation.

See also

returnTraversedJunctions

returnTraversedTurns Property returnTraversedTurns Boolean |null |undefined Since: ArcGIS Maps SDK for JavaScript 4.25 ClosestFacilityParameters since 4.20, returnTraversedTurns added at 4.25.

Specify whether traversed turns will be returned by the operation.

See also

returnTraversedTurns

returnZ Property returnZ Boolean |null |undefined Since: ArcGIS Maps SDK for JavaScript 4.25 ClosestFacilityParameters since 4.20, returnZ added at 4.25.

Include z values for the returned geometries if supported by the underlying network.

See also

returnZ

timeOfDay Property timeOfDay Date |String |null |undefined

Specify the time and date to depart from or arrive at incidents or facilities. You can also specify a value of "now", to set the depart or arrive time to current time.

For ClosestFacilityParameters the timeOfDay is always "now".

See also

timeOfDay

timeOfDayIsUTC Property timeOfDayIsUTC Boolean |null |undefined Since: ArcGIS Maps SDK for JavaScript 4.25 ClosestFacilityParameters since 4.20, timeOfDayIsUTC added at 4.25.

Specify the time zone or zones of the timeOfDay property.

See also

timeOfDayIsUTC

timeOfDayUsage Property timeOfDayUsage String |null |undefined

The timeOfDay parameter value represents the arrival or departure time for the routes.

Possible Values:"start" |"end" |"not-used"

See also

timeOfDayUsage

travelDirection Property travelDirection String |null |undefined

Specifies how the travel direction for the closest facility search will be measured.

Possible Value	Description
from-facility	Direction of travel is from facilities to incidents.
to-facility	Direction of travel is from incidents to facilities.

Possible Values:"from-facility" |"to-facility"

See also

travelDirection

travelMode Property travelMode TravelMode |null |undefinedautocast

A travel mode represents a means of transportation, such as driving or walking. Travel modes define the physical characteristics of a vehicle or pedestrian.

Use networkService.fetchServiceDescription to obtain a list of predefined travel modes and the default travel mode that is used if one is not specified in a routing reqest.

See also

useHierarchy Property useHierarchy Boolean |null |undefined

Specify whether hierarchy should be used when finding the shortest paths. This value is ignored if a travelMode is specified.

Default Value:false

See also

useHierarchy

Method Overview

Show inherited methods

Hide inherited methods

Return Type	Summary	Class
	Adds one or more handles which are to be tied to the lifecycle of the object.	Accessor
this	Creates a deep clone of this object.	ClosestFacilityParameters
*\|null\|undefined	Creates a new instance of this class and initializes it with values from a JSON object generated from an ArcGIS product.	ClosestFacilityParameters
Boolean	Returns true if a named group of handles exist.	Accessor
	Removes a group of handles owned by the object.	Accessor
Object	Converts an instance of this class to its ArcGIS portal JSON representation.	ClosestFacilityParameters

Method Details

addHandles Inherited Method addHandles(handleOrHandles, groupKey) Inherited from Accessor Since: ArcGIS Maps SDK for JavaScript 4.25 Accessor since 4.0, addHandles added at 4.25.

Adds one or more handles which are to be tied to the lifecycle of the object. The handles will be removed when the object is destroyed.

// Manually manage handles
const handle = reactiveUtils.when(
  () => !view.updating,
  () => {
    wkidSelect.disabled = false;
  },
  { once: true }
);

this.addHandles(handle);

// Destroy the object
this.destroy();

Parameters

handleOrHandles WatchHandle|WatchHandle []

Handles marked for removal once the object is destroyed.

groupKey *

optional

Key identifying the group to which the handles should be added. All the handles in the group can later be removed with Accessor.removeHandles(). If no key is provided the handles are added to a default group.

clone Method clone(){this}

Creates a deep clone of this object. Any properties that store values by reference will be assigned copies of the referenced values on the cloned instance.

Returns

Type	Description
this	A deep clone of the class instance that invoked this method.

fromJSON Method fromJSON(json){* |null |undefined}static

Creates a new instance of this class and initializes it with values from a JSON object generated from an ArcGIS product. The object passed into the input json parameter often comes from a response to a query operation in the REST API or a toJSON() method from another ArcGIS product. See the Using fromJSON() topic in the Guide for details and examples of when and how to use this function.

Parameter

json Object

A JSON representation of the instance in the ArcGIS format. See the ArcGIS REST API documentation for examples of the structure of various input JSON objects.

Returns

Type	Description
* \| null \| undefined	Returns a new instance of this class.

hasHandles Inherited Method hasHandles(groupKey){Boolean} Inherited from Accessor Since: ArcGIS Maps SDK for JavaScript 4.25 Accessor since 4.0, hasHandles added at 4.25.

Returns true if a named group of handles exist.

Parameter

groupKey *

optional

A group key.

Returns

Type	Description
Boolean	Returns `true` if a named group of handles exist.

Example

// Remove a named group of handles if they exist.
if (obj.hasHandles("watch-view-updates")) {
  obj.removeHandles("watch-view-updates");
}

removeHandles Inherited Method removeHandles(groupKey) Inherited from Accessor Since: ArcGIS Maps SDK for JavaScript 4.25 Accessor since 4.0, removeHandles added at 4.25.

Removes a group of handles owned by the object.

Parameter

groupKey *

optional

A group key or an array or collection of group keys to remove.

Example

obj.removeHandles(); // removes handles from default group

obj.removeHandles("handle-group");
obj.removeHandles("other-handle-group");

toJSON Method toJSON(){Object}

Converts an instance of this class to its ArcGIS portal JSON representation. See the Using fromJSON() guide topic for more information.

Returns

Type	Description
Object	The ArcGIS portal JSON representation of an instance of this class.

Type Definitions

AttributeParameterValue Type Definition AttributeParameterValue

An object describing the parameter values for the attributeParameterValues property of ClosestFacilityParameters.

Properties: attributeName String

The name of the restriction.

parameterName String

The name of the parameter associated with the restriction. A restriction can have one or more parameterName properties.

value String|Number|null|undefined

The value for parameterName.