Packagecom.esri.baserver.tasks.tradeareas
Classpublic class ThresholdRingsRadiiParameters
InheritanceThresholdRingsRadiiParameters Inheritance BAUtilityParameters Inheritance BABaseParameters Inheritance Object
Implements IBAResultProcessor

The ThresholdRingsRadiiParameters class provides input parameters for the Threshold Rings Radii task.

The analysis can be restricted to an analysis extent if the analysisExtent parameter is specified. Optional singleStoreID parameter restricts the analysis to a single store of the store layer.

View the examples

See also

ThresholdRingsRadiiTask


Public Properties
 PropertyDefined By
 InheritedactiveDatasetID : String
Active dataset ID.
BAUtilityParameters
  analysisExtent : Geometry
Spatial/geographic extent to restrict analysis by.
ThresholdRingsRadiiParameters
  outputUnits : String
The output distance units the radii of threshold rings will be calculated in.
ThresholdRingsRadiiParameters
  radii : Array
An array of threshold values (required).
ThresholdRingsRadiiParameters
 InheritedresultType : BAResultType
[read-only] Type of a result returned by the task associated with these parameters.
BABaseParameters
  singleStoreID : String
ID of a single store in the stores layer to calculate threshold ring radii for.
ThresholdRingsRadiiParameters
  storeIDField : String
The attribute field name in the input stores layer which is associated with unique store/business IDs (typically store numbers for retail establishments with multiple locations).
ThresholdRingsRadiiParameters
  stores : PointLayer
A point layer containing point features such as businesses, hospitals, schools, etc., which represent the locations from which the Threshold Rings will originate (required).
ThresholdRingsRadiiParameters
  summarizationField : String
The attribute field name in the input thresholdData layer which specifies a demographic field to be used for summarization (required).
ThresholdRingsRadiiParameters
 InheritedtaskName : String
[read-only] Name of a Business Analyst Server task associated with these parameters.
BABaseParameters
  thresholdData : Boundaries
A polygon layer to apply summarization by (required).
ThresholdRingsRadiiParameters
Public Methods
 MethodDefined By
  
Creates a new instance of the ThresholdRingsRadiiParameters class.
ThresholdRingsRadiiParameters
Property Detail
analysisExtentproperty
analysisExtent:Geometry

Spatial/geographic extent to restrict analysis by. This parameter expects a value of the Extent or Polygon type.


Implementation
    public function get analysisExtent():Geometry
    public function set analysisExtent(value:Geometry):void

See also

outputUnitsproperty 
outputUnits:String

The output distance units the radii of threshold rings will be calculated in. This should be a string constant from the com.esri.ags.Units class.

The default value is Units.MILES.


Implementation
    public function get outputUnits():String
    public function set outputUnits(value:String):void
radiiproperty 
radii:Array

An array of threshold values (required). This property expects an array containing one or more positive numerical values.


Implementation
    public function get radii():Array
    public function set radii(value:Array):void
singleStoreIDproperty 
singleStoreID:String

ID of a single store in the stores layer to calculate threshold ring radii for.


Implementation
    public function get singleStoreID():String
    public function set singleStoreID(value:String):void
storeIDFieldproperty 
storeIDField:String

The attribute field name in the input stores layer which is associated with unique store/business IDs (typically store numbers for retail establishments with multiple locations).

The default value is "STORE_ID".


Implementation
    public function get storeIDField():String
    public function set storeIDField(value:String):void
storesproperty 
stores:PointLayer

A point layer containing point features such as businesses, hospitals, schools, etc., which represent the locations from which the Threshold Rings will originate (required). In situations where the input stores parameter does not contain a field named "STORE_ID" (case insensitive), specification of the storeIDField parameter is required so the analyses can be properly executed.


Implementation
    public function get stores():PointLayer
    public function set stores(value:PointLayer):void
summarizationFieldproperty 
summarizationField:String

The attribute field name in the input thresholdData layer which specifies a demographic field to be used for summarization (required).


Implementation
    public function get summarizationField():String
    public function set summarizationField(value:String):void
thresholdDataproperty 
thresholdData:Boundaries

A polygon layer to apply summarization by (required).


Implementation
    public function get thresholdData():Boundaries
    public function set thresholdData(value:Boundaries):void
Constructor Detail
ThresholdRingsRadiiParameters()Constructor
public function ThresholdRingsRadiiParameters()

Creates a new instance of the ThresholdRingsRadiiParameters class.

Examples
ActionScript to create ThresholdRingsRadiiParameters and then use in a Threshold Rings Radii task:
                      
     var parameters : ThresholdRingsRadiiParameters = new ThresholdRingsRadiiParameters();
     
     // The PointLayer type could take either data as type
     // com.esri.ags.tasks.FeatureSet, com.esri.baserver.FolderItem,
     // or an array of com.esri.bacore.PointRecord items, e.g.
     //var points:Array = [new PointRecord("store_1", "Store 1", "1", 34.052074, -117.207841)];
     
     // Set stores as an array of PointRecord items.
     parameters.stores = new PointLayer(points);
     
     // The storeIDField parameter is ignored if stores are specified as an array of PointRecord.
     //parameters.storeIDField = "STORE_ID";
     
     // Optionally restrict analysis to myExtent that is a value of the Extent or Polygon type.
     //parameters.analysisExtent = myExtent;
     
     // Set a data layer to apply summarization by.
     parameters.thresholdData = new Boundaries(new StandardLayer("US.ZIP5", zipCodesArray));
     
     // Set threshold values.
     parameters.radii = [ 500, 1000, 2000 ];
     
     // Set a summarization field.
     parameters.summarizationField = "TOTHH_CY";
     
     // Units.MILES is the default value for outputUnits.
     //parameters.outputUnits = Units.MILES;
     
     thresholdRingsRadiiTask.execute(parameters, new Responder(resultHandler, faultHandler));