Packagecom.esri.ags.tasks.supportClasses
Classpublic class ServiceAreaParameters
InheritanceServiceAreaParameters Inheritance Object

Since : ArcGIS API for Flex 2.0

Input parameters for a ServiceAreaTask.

Note: ServiceAreaParameters, and other service area related classes, requires ArcGIS Server 10.0 or above and a "service area" layer. A "service area" layer is a layer of type "esriNAServerServiceAreaLayer".

If you don't specify any barriers, the server will use the predefined barriers from the server. To use neither the predefined barriers, nor any user-defined ones, set the pointBarriers, polylineBarriers and polygonBarriers to empty arrays. The same applies to facilities.

View the examples

See also

com.esri.ags.tasks.ServiceAreaTask
Barriers in Network Analysis [ArcGIS desktop help]


Public Properties
 PropertyDefined By
  accumulateAttributes : Array
The list of network attribute names to be accumulated with the analysis, i.e., which attributes should be returned as part of the response.
ServiceAreaParameters
  attributeParameterValues : Array
A set of attribute parameter values that can be parameterized to determine which network elements can be used by a vehicle.
ServiceAreaParameters
  defaultBreaks : Array
A comma-separated list of doubles.
ServiceAreaParameters
  doNotLocateOnRestrictedElements : Boolean = false
If true, avoid network elements restricted by barriers or due to restrictions specified in restrictionAttributes.
ServiceAreaParameters
  excludeSourcesFromPolygons : Array
A comma-separated list of string names.
ServiceAreaParameters
  facilities : Object
The set of facilities loaded as network locations during analysis.
ServiceAreaParameters
  impedanceAttribute : String
The network attribute name to be used as the impedance attribute in analysis.
ServiceAreaParameters
  mergeSimilarPolygonRanges : Boolean
If true, similar ranges will be merged in the result polygons.
ServiceAreaParameters
  outputGeometryPrecision : Number
The precision of the output geometry after generalization.
ServiceAreaParameters
  outputGeometryPrecisionUnits : String
The units of the output geometry precision.
ServiceAreaParameters
  outputLines : String
The type of output lines to be generated in the result.
ServiceAreaParameters
  outputPolygons : String
The type of output polygon(s) to be generated in the result.
ServiceAreaParameters
  outSpatialReference : SpatialReference
The well-known ID of the spatial reference for the geometries returned with the analysis results.
ServiceAreaParameters
  overlapLines : Boolean
Indicates if the lines should overlap from multiple facilities.
ServiceAreaParameters
  overlapPolygons : Boolean
Indicates if the polygons for all facilities should overlap.
ServiceAreaParameters
  pointBarriers : Object
The set of point barrier loaded as network locations during analysis.
ServiceAreaParameters
  polygonBarriers : Object
The set of polygon barrier loaded as network locations during analysis.
ServiceAreaParameters
  polylineBarriers : Object
The set of polyline barrier loaded as network locations during analysis.
ServiceAreaParameters
  restrictionAttributes : Array
The list of network attribute names to be used as restrictions with the analysis.
ServiceAreaParameters
  restrictUTurns : String
Specifies how U-turns should be handled.
ServiceAreaParameters
  returnFacilities : Boolean = false
If true, facilities will be returned with the analysis results.
ServiceAreaParameters
  returnPointBarriers : Boolean = false
If true, barriers will be returned in the barriers property of ClosestFacilitySolveResult.
ServiceAreaParameters
  returnPolygonBarriers : Boolean = false
If true, polygon barriers will be returned in the polygonBarriers property of ClosestFacilitySolveResult.
ServiceAreaParameters
  returnPolylineBarriers : Boolean = false
If true, polyline barriers will be returned in the polylineBarriers property of ClosestFacilitySolveResult.
ServiceAreaParameters
  splitLinesAtBreaks : Boolean
If true, lines will be split at breaks.
ServiceAreaParameters
  splitPolygonsAtBreaks : Boolean
If true, polygons will be split at breaks.
ServiceAreaParameters
  travelDirection : String
Options for traveling to or from the facility.
ServiceAreaParameters
  trimOuterPolygon : Boolean
If true, the outermost polygon (at the maximum break value) will be trimmed.
ServiceAreaParameters
  trimPolygonDistance : Number
If polygons are being trimmed, provides the distance to trim.
ServiceAreaParameters
  trimPolygonDistanceUnits : String
If polygons are being trimmed, specifies the units of the trimPolygonDistance.
ServiceAreaParameters
Property Detail
accumulateAttributesproperty
public var accumulateAttributes:Array

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".

See also

attributeParameterValuesproperty 
public var attributeParameterValues:Array

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 charactersitic is compared to a value coming from a descriptor attribute to determine whether or not a network element is traversible. 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 vehicles height is greater than the clearance, the edge is restricted. Parameterized cost attributes that can 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 traversible network paths can be adjusted with respect to changes in traffic speeds.

See also

defaultBreaksproperty 
public var defaultBreaks:Array

A comma-separated list of doubles. The default is defined in the network analysis layer.

doNotLocateOnRestrictedElementsproperty 
public var doNotLocateOnRestrictedElements:Boolean = false

Since : ArcGIS API for Flex 2.1

If true, avoid network elements restricted by barriers or due to restrictions specified in restrictionAttributes.

The default value is false.

excludeSourcesFromPolygonsproperty 
public var excludeSourcesFromPolygons:Array

A comma-separated list of string names. The default is defined in the network analysis layer.

facilitiesproperty 
public var facilities:Object

The set of facilities loaded as network locations during analysis. Can be either an instance of DataLayer or FeatureSet.

See also

impedanceAttributeproperty 
public var impedanceAttribute:String

The network attribute name to be used as the impedance attribute in 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". 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.

See also

mergeSimilarPolygonRangesproperty 
mergeSimilarPolygonRanges:Boolean

If true, similar ranges will be merged in the result polygons. The default is defined in the network analysis layer in your ServiceAreaTask.


Implementation
    public function get mergeSimilarPolygonRanges():Boolean
    public function set mergeSimilarPolygonRanges(value:Boolean):void
outputGeometryPrecisionproperty 
public var outputGeometryPrecision:Number

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 - generalization is performed according to IPolycurve.Generalize.

outputGeometryPrecisionUnitsproperty 
public var outputGeometryPrecisionUnits:String

The units of the output geometry precision.

The default value is esriUnknownUnits.

outputLinesproperty 
public var outputLines:String

The type of output lines to be generated in the result. The default is as defined in the specific routing network layer used in your RouteTask. Possible values are "esriNAOutputLineNone" (no line at all), "esriNAOutputLineStraight" (a straight line from start to end) and "esriNAOutputLineTrueShape".

See also

outputPolygonsproperty 
public var outputPolygons:String

The type of output polygon(s) to be generated in the result. The default is as defined in the specific routing network layer used in your ServiceAreaTask. Possible values are "esriNAOutputLineNone" (no polygon at all), "esriNAOutputPolygonSimplified" and "esriNAOutputPolygonDetailed".

See also

outSpatialReferenceproperty 
public var outSpatialReference:SpatialReference

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

overlapLinesproperty 
overlapLines:Boolean

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


Implementation
    public function get overlapLines():Boolean
    public function set overlapLines(value:Boolean):void
overlapPolygonsproperty 
overlapPolygons:Boolean

Indicates if the polygons for all facilities should overlap. The default is defined in the network analysis layer in your ServiceAreaTask.


Implementation
    public function get overlapPolygons():Boolean
    public function set overlapPolygons(value:Boolean):void
pointBarriersproperty 
public var pointBarriers:Object

The set of point barrier loaded as network locations during analysis. Can be either an instance of DataLayer or FeatureSet.

See also

polygonBarriersproperty 
public var polygonBarriers:Object

The set of polygon barrier loaded as network locations during analysis. Can be either an instance of DataLayer or FeatureSet.

See also

polylineBarriersproperty 
public var polylineBarriers:Object

The set of polyline barrier loaded as network locations during analysis. Can be either an instance of DataLayer or FeatureSet.

See also

restrictionAttributesproperty 
public var restrictionAttributes:Array

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. Possible values are listed in the Service Directory under "Network Dataset -> Network Attributes". You can also specify a value of "none" to indicate that no network attributes should be used as restrictions. If you specify an empty array, it will default to the default of the service.


Example
ActionScript to use restrictionAttributes:
     myRouteParams.restrictionAttributes = ["OneWay"];
ActionScript to not use the service defaults for restrictions:
     myRouteParams.restrictionAttributes = ["none"];
restrictUTurnsproperty 
public var restrictUTurns:String

Specifies how U-turns should be handled. The default is as defined in the specific routing network layer used in your RouteTask. Possible values are "esriNFSBAllowBacktrack", "esriNFSBAtDeadEndsOnly", "esriNFSBNoBacktrack" and "esriNFSBAtDeadEndsAndIntersections".

See also

returnFacilitiesproperty 
public var returnFacilities:Boolean = false

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

The default value is false.

returnPointBarriersproperty 
public var returnPointBarriers:Boolean = false

If true, barriers will be returned in the barriers property of ClosestFacilitySolveResult.

The default value is false.

See also

returnPolygonBarriersproperty 
public var returnPolygonBarriers:Boolean = false

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

The default value is false.

See also

returnPolylineBarriersproperty 
public var returnPolylineBarriers:Boolean = false

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

The default value is false.

See also

splitLinesAtBreaksproperty 
splitLinesAtBreaks:Boolean

If true, lines will be split at breaks. The default is defined in the network analysis layer in your ServiceAreaTask.


Implementation
    public function get splitLinesAtBreaks():Boolean
    public function set splitLinesAtBreaks(value:Boolean):void
splitPolygonsAtBreaksproperty 
splitPolygonsAtBreaks:Boolean

If true, polygons will be split at breaks. The default is defined in the network analysis layer in your ServiceAreaTask.


Implementation
    public function get splitPolygonsAtBreaks():Boolean
    public function set splitPolygonsAtBreaks(value:Boolean):void
travelDirectionproperty 
public var travelDirection:String

Options for traveling to or from the facility. The default is defined in the network layer.

See also

trimOuterPolygonproperty 
trimOuterPolygon:Boolean

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.


Implementation
    public function get trimOuterPolygon():Boolean
    public function set trimOuterPolygon(value:Boolean):void
trimPolygonDistanceproperty 
public var trimPolygonDistance:Number

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

trimPolygonDistanceUnitsproperty 
public var trimPolygonDistanceUnits:String

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

Examples
ActionScript to use ServiceAreaParameters:
 <esri:ServiceAreaParameters id="serviceAreaParameters" facilities="{myFacilities}"/>
MXML to use ServiceAreaParameters:
 <esri:ServiceAreaParameters id="serviceAreaParams"
    facilities="{facilitiesFS}"
    directionsLengthUnits="esriMiles"
    outSpatialReference="{myMap.spatialReference}"/>