com.esri.arcgis.networkanalyst
Interface INAServiceAreaSolver

All Superinterfaces:
Serializable
All Known Subinterfaces:
INAServiceAreaSolver2
All Known Implementing Classes:
NAServerServiceAreaParams, NAServiceAreaSolver

public interface INAServiceAreaSolver
extends Serializable

Provides access to the service area solver.

Superseded By

INAServiceAreaSolver2

Remarks

INAServerSolverResults has been superseded by INAServerSolverResults2.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.


Method Summary
 IDoubleArray getDefaultBreaks()
          The default break(s) of the traversal.
 IStringArray getExcludeSourcesFromPolygons()
          A collection of network source names to NOT use when generating polygons.
 int getOutputLines()
          The type of line(s) generated.
 int getOutputPolygons()
          The type of polygon(s) generated.
 int getTravelDirection()
          The direction of the traversal.
 boolean isMergeSimilarPolygonRanges()
          Indicates if similar ranges should be merged in the result polygons.
 boolean isOverlapLines()
          Indicates if lines should overlap from multiple facilities.
 boolean isSplitLinesAtBreaks()
          Indicates if lines should be split at breaks.
 boolean isSplitPolygonsAtBreaks()
          Indicates if polygons should be split at break values.
 void setDefaultBreaks(IDoubleArray value)
          The default break(s) of the traversal.
 void setExcludeSourcesFromPolygons(IStringArray networkSourceNames)
          A collection of network source names to NOT use when generating polygons.
 void setMergeSimilarPolygonRanges(boolean value)
          Indicates if similar ranges should be merged in the result polygons.
 void setOutputLines(int value)
          The type of line(s) generated.
 void setOutputPolygons(int value)
          The type of polygon(s) generated.
 void setOverlapLines(boolean value)
          Indicates if lines should overlap from multiple facilities.
 void setSplitLinesAtBreaks(boolean value)
          Indicates if lines should be split at breaks.
 void setSplitPolygonsAtBreaks(boolean value)
          Indicates if polygons should be split at break values.
 void setTravelDirection(int value)
          The direction of the traversal.
 

Method Detail

getTravelDirection

int getTravelDirection()
                       throws IOException,
                              AutomationException
The direction of the traversal.

Remarks

TravelDirection specifies if it is traveling from the facility (default) or traveling to the facility.

This can make a difference in the computed service area if there are oneway restrictions, turn restrictions, or different travel cost attributes for each side of the street in the network.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
A com.esri.arcgis.networkanalyst.esriNATravelDirection constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setTravelDirection

void setTravelDirection(int value)
                        throws IOException,
                               AutomationException
The direction of the traversal.

Remarks

TravelDirection specifies if it is traveling from the facility (default) or traveling to the facility.

This can make a difference in the computed service area if there are oneway restrictions, turn restrictions, or different travel cost attributes for each side of the street in the network.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
value - A com.esri.arcgis.networkanalyst.esriNATravelDirection constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getDefaultBreaks

IDoubleArray getDefaultBreaks()
                              throws IOException,
                                     AutomationException
The default break(s) of the traversal.

Remarks

DefaultBreaks specifies how many rings to compute around each facility.

The breaks are specified as a double array of numbers like 2.0, 4.0, 6.0. This will result in three polygons around the facility at 2.0, 4.0 and 6.0 cumulative attribute value units from each facility.

DefaultBreaks is considered “default” because it can be overridden on a feature-by-feature basis by the presence of a non-null value in the Breaks_<attribute name> field of an individual feature.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
A reference to a com.esri.arcgis.system.IDoubleArray
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setDefaultBreaks

void setDefaultBreaks(IDoubleArray value)
                      throws IOException,
                             AutomationException
The default break(s) of the traversal.

Remarks

DefaultBreaks specifies how many rings to compute around each facility.

The breaks are specified as a double array of numbers like 2.0, 4.0, 6.0. This will result in three polygons around the facility at 2.0, 4.0 and 6.0 cumulative attribute value units from each facility.

DefaultBreaks is considered “default” because it can be overridden on a feature-by-feature basis by the presence of a non-null value in the Breaks_<attribute name> field of an individual feature.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
value - A reference to a com.esri.arcgis.system.IDoubleArray (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isSplitPolygonsAtBreaks

boolean isSplitPolygonsAtBreaks()
                                throws IOException,
                                       AutomationException
Indicates if polygons should be split at break values.

Remarks

SplitPolygonsAtBreaks specifies to the solver if the service area polygons will be split at the specified breaks. If they are not split, each break value gets a polygon starting from the start facility. If they are split at break values, then each polygon is like a donut (i.e., starts at the previous break value and ends at the next break value).

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
The value
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setSplitPolygonsAtBreaks

void setSplitPolygonsAtBreaks(boolean value)
                              throws IOException,
                                     AutomationException
Indicates if polygons should be split at break values.

Remarks

SplitPolygonsAtBreaks specifies to the solver if the service area polygons will be split at the specified breaks. If they are not split then each break value gets a polygon starting from the start facility. If they are split at break values, then each polygon is like a donut (i.e. starts at the previous break value and ends at the next break value).

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
value - The value (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isOverlapLines

boolean isOverlapLines()
                       throws IOException,
                              AutomationException
Indicates if lines should overlap from multiple facilities.

Remarks

OverlapLines specifies if the service area lines of two or more facilities will overlap and return coincident features.

A break value of 3.0 minutes will return all of the lines that can be reached within 3.0 minutes of the facility. If OverlapLines is set to false then only the line to the closest facility will be returned. In cases where parts of a line correspond to different facilities, the single line will be split and the two resulting lines will be apportioned appropriately.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
The value
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setOverlapLines

void setOverlapLines(boolean value)
                     throws IOException,
                            AutomationException
Indicates if lines should overlap from multiple facilities.

Remarks

OverlapLines specifies if the service area lines of two or more facilities will overlap and return coincident features.

A break value of 3.0 minutes will return all of the lines that can be reached within 3.0 minutes of the facility. If OverlapLines is set to false then only the line to the closest facility will be returned. In cases where parts of a line correspond to different facilities, the single line will be split and the two resulting lines will be apportioned appropriately.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
value - The value (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getExcludeSourcesFromPolygons

IStringArray getExcludeSourcesFromPolygons()
                                           throws IOException,
                                                  AutomationException
A collection of network source names to NOT use when generating polygons.

Remarks

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

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
A reference to a com.esri.arcgis.system.IStringArray
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setExcludeSourcesFromPolygons

void setExcludeSourcesFromPolygons(IStringArray networkSourceNames)
                                   throws IOException,
                                          AutomationException
A collection of network source names to NOT use when generating polygons.

Remarks

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

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
networkSourceNames - A reference to a com.esri.arcgis.system.IStringArray (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isMergeSimilarPolygonRanges

boolean isMergeSimilarPolygonRanges()
                                    throws IOException,
                                           AutomationException
Indicates if similar ranges should be merged in the result polygons.

Remarks

MergeSimillarPolygons specifies if polygons with same break values from different facilities should be merged together.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
The value
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setMergeSimilarPolygonRanges

void setMergeSimilarPolygonRanges(boolean value)
                                  throws IOException,
                                         AutomationException
Indicates if similar ranges should be merged in the result polygons.

Remarks

MergeSimillarPolygons specifies if polygons with same break values from different facilities should be merged together.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
value - The value (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isSplitLinesAtBreaks

boolean isSplitLinesAtBreaks()
                             throws IOException,
                                    AutomationException
Indicates if lines should be split at breaks.

Remarks

SplitLinesAtBreaks specifies if the service area lines will be split at the break values.

A service area with a set of break values like 2.0, 4.0, 6.0 will normally only return each edge in the input network with its from and to cumulative cost attribute. If this property is set to true, service area lines are also split at the location where the actual value of the break is reached.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
The value
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setSplitLinesAtBreaks

void setSplitLinesAtBreaks(boolean value)
                           throws IOException,
                                  AutomationException
Indicates if lines should be split at breaks.

Remarks

SplitLinesAtBreaks specifies if the service area lines will be split at the break values.

A service area with a set of break values like 2.0, 4.0, 6.0 will normally only return each edge in the input network with its from and to cumulative cost attribute. If this property is set to true, service area lines are also split at the location where the actual value of the break is reached.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
value - The value (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getOutputPolygons

int getOutputPolygons()
                      throws IOException,
                             AutomationException
The type of polygon(s) generated.

Remarks

OutputPolygons specifies if the service area polygons should be generated or not.

If they are to be generated, it specifies the type of polygons to be generated. For example, the choice could be simplified, detailed, or none. The detailed option accurately models the service area lines and may contain islands of unreached areas. The simplified option runs faster but is not as accurate at some fringes.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
A com.esri.arcgis.networkanalyst.esriNAOutputPolygonType constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setOutputPolygons

void setOutputPolygons(int value)
                       throws IOException,
                              AutomationException
The type of polygon(s) generated.

Remarks

OutputPolygons specifies if the service area polygons should be generated or not.

If they are to be generated it specifies the type of polygons to be generated. For example, the choice could be simplified, detailed or none. The detailed option accurately models the service area lines and may contain islands of unreached areas. The simplified option runs faster but is not as accurate at some fringes.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
value - A com.esri.arcgis.networkanalyst.esriNAOutputPolygonType constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getOutputLines

int getOutputLines()
                   throws IOException,
                          AutomationException
The type of line(s) generated.

Remarks

OutputLines specifies the type of lines to be generated by the service area solver. The choice is to the generate the lines with or without measures or to generate no lines.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
A com.esri.arcgis.networkanalyst.esriNAOutputLineType constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setOutputLines

void setOutputLines(int value)
                    throws IOException,
                           AutomationException
The type of line(s) generated.

Remarks

OutputLines specifies the type of lines to be generated by the service area solver. The choice is to the generate the lines with or without measures or to generate no lines.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
value - A com.esri.arcgis.networkanalyst.esriNAOutputLineType constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.