Property Overview

Property Details

accumulateAttributesString[]

The list of network attribute names to be accumulated with the analysis (i.e. which attributes should be returned as part of the response). The default is as defined in the specific routing network layer used in your RouteTask. You can specify any attributes names listed in the Service Directory under Network Dataset > Network Attributes as Usage Type: esriNAUTCost.

attributeParameterValuesObject[]

A set of attribute parameter values that can be parameterized to determine which network elements can be used by a vehicle. The parameter holding a vehicle characteristic is compared to a value coming from a descriptor attribute to determine whether or not a network element is traversable. For example, a parameterized restriction attribute can compare the height of your vehicle with a descriptor attribute that holds the clearance under overpasses through tunnels. If the vehicle's height is greater than the clearance, the edge is restricted.

Parameterized cost attributes that reference other cost attributes and scale them, can also be used. This is useful when inclement weather like ice, fog or heavy rain, descends on the study area and hinders normal flow of traffic. By having a parameter already outfitted on a cost attribute, travel-time expectations and traversable network paths can be adjusted with respect to changes in traffic speeds.

declaredClassStringreadonly inherited

Since: ArcGIS API for JavaScript 4.7

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

defaultBreaksNumber[]

An array of numbers defining the breaks. The default value is defined in the network analysis layer.

doNotLocateOnRestrictedElementsBoolean

When true, restricted network elements should be considered when finding network locations.

Default Value:true

excludeSourcesFromPolygonsString[]

An array of network source names to NOT use when generating polygons. This property specifies if certain network sources should be excluded from the service area polygon generation. A service area on a multi-modal network where only one mode is being used to compute the service area would get a more appropriate shape if other modes are excluded from the polygons.

facilitiesDataLayer|FeatureSet

The set of facilities loaded as network locations during analysis. At ArcGIS Server 10.1, an optional url property was added. Use this property to specify a REST query request to a Feature, Map or GP Service that returns a JSON feature set. The url property can be specified using DataFile. Note that either the features or url property should be specified.

impedanceAttributeString

The network attribute name used as the impedance attribute in analysis. The default is as defined in the routing network layer used in your RouteTask. You can specify any attribute names listed in the Service Directory under Network Dataset > Network Attributes as Usage Type: esriNAUTCost. You can also specify a value of none to indicate that no network attributes should be used for impedance. If you specify an empty string, it will use the default of the service.

For example, set impedanceAttribute = 'Time' for quickest route and impedanceAttribute = 'Length' for shortest drive, assuming the service has those two esriNAUTCost attributes.

View the Understanding the network attribute ArcGIS desktop help topic for more details.

mergeSimilarPolygonRangesBoolean

If true, similar ranges will be merged in the resulting polygons.

Default Value:false

outputGeometryPrecisionNumber

The precision of the output geometry after generalization. If 0, no generalization of output geometry is performed. If present and positive, it represents the MaximumAllowableOffset parameter and generalization is performed according to IPolycurve.Generalize.

outputGeometryPrecisionUnitsString

The units of the output geometry precision.

Possible Values: centimeters | decimal-degrees | decimeters | feet | inches | kilometers | meters | miles | millimeters | nautical-miles | points | yards

outputLinesString

The type of output lines to be generated in the result. The default is defined in the specific routing network layer used in your ServiceAreaTask.

Possible Value	Description
none	No lines are returned
straight	Only returns straight lines
true-shape	Return the true shape of the lines
true-shape-with-measure	Return the true shape of the lines with their measurements

outputPolygonsString

The type of output polygons to be generated in the result. The default is as defined in the specific routing network layer used in your ServiceAreaTask.

Possible Values: none | simplified | detailed

outSpatialReferenceSpatialReference

The well-known ID of the spatial reference for the geometries returned with the analysis results. If outSpatialReference is not specified, the geometries are returned in the spatial reference of the view.

overlapLinesBoolean

Indicates if the lines should overlap from multiple facilities. The default is defined by the network analysis layer in your ServiceAreaTask.

Default Value:false

overlapPolygonsBoolean

Indicates if the polygons should overlap from multiple facilities. The default is defined by the network analysis layer in your ServiceAreaTask.

Default Value:false

pointBarriersDataLayer|FeatureSet

The set of point barriers loaded as network locations during analysis. At ArcGIS Server 10.1, an optional url property was added. Use this property to specify a REST query request to a Feature, Map or GP Service that returns a JSON feature set. The url property can be specified using DataFile. Note that either the features or url property should be specified.

polygonBarriersDataLayer|FeatureSet

The set of polygon barriers loaded as network locations during analysis. At ArcGIS Server 10.1, an optional url property was added. Use this property to specify a REST query request to a Feature, Map or GP Service that returns a JSON feature set. The url property can be specified using DataFile. Note that either the features or url property should be specified.

polylineBarriersDataLayer|FeatureSet

The set of polyline barriers loaded as network locations during analysis. At ArcGIS Server 10.1, an optional url property was added. Use this property to specify a REST query request to a Feature, Map or GP Service that returns a JSON feature set. The url property can be specified using DataFile. Note that either the features or url property should be specified.

restrictionAttributesString[]

The list of network attribute names to be used as restrictions with the analysis. The default is as defined in the specific routing network layer used in your RouteTask. You can specify any attributes names listed in the Service Directory under Network Dataset > Network Attributes as Usage Type: esriNAUTCost.

restrictUTurnsString

Specifies how U-turns should be handled. The default is defined in the routing network layer used in your RouteTask.

Possible Value	Description
allow-backtrack	Allows U-turns on everywhere
at-dead-ends-only	Only allows U-turns at dead ends
no-backtrack	Restricts U-turns everywhere
at-dead-ends-and-intersections	Only allows U-turns at dead ends and intersections

returnFacilitiesBoolean

If true, facilities will be returned with the analysis results.

Default Value:false

returnPointBarriersBoolean

If true, point barriers will be returned in the pointBarriers property of the analysis results.

Default Value:false

returnPolygonBarriersBoolean

If true, polygon barriers will be returned in the polygonBarriers property of the analysis results.

Default Value:false

returnPolylineBarriersBoolean

If true, polyline barriers will be returned in the polylineBarriers property of the analysis results.

Default Value:false

splitLinesAtBreaksBoolean

If true, lines will be split at breaks.

Default Value:false

splitPolygonsAtBreaksBoolean

If true, polygons will be split at breaks.

Default Value:false

timeOfDayDate

Local date and time at the facility. If travelDirection = "to-facility", the timeOfDay value specifies arrival time at the facility. if travelDirection = "from-facility", timeOfDay specifies departure time from the facility. Requires ArcGIS Server service version 10.1 or greater.

travelDirectionString

Options for traveling to or from the facility. Default values are defined by the network layer.

Possible Value	Description
from-facility	Sets travel direction from the facility
to-facility	Sets travel direction to the facility

trimOuterPolygonBoolean

If true, the outermost polygon (at the maximum break value) will be trimmed. The default is defined in the network analysis layer in your ServiceAreaTask.

Default Value:false

trimPolygonDistanceNumber

If polygons are being trimmed, provides the distance to trim. The default value is defined in the network analysis layer.

trimPolygonDistanceUnitsString

If polygons are being trimmed, specifies the units of trimPolygonDistance. The default is defined in the network analysis layer.

useHierarchyBoolean

When true, the hierarchy attributes for the network will be used in the analysis. The default value is defined in the network layer. useHierarchy cannot be used in conjunction with outputLines. Requires an ArcGIS Server service version 10.1 or greater.

Method Overview

Method Details

toJSON(){Object}

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

Returns:

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