com.esri.arcgis.geoprocessing.tools.networkanalysttools
Class MakeRouteLayer

java.lang.Object
  com.esri.arcgis.geoprocessing.AbstractGPTool
      com.esri.arcgis.geoprocessing.tools.networkanalysttools.MakeRouteLayer

All Implemented Interfaces:

GPTool

public class MakeRouteLayer
extends AbstractGPTool

Makes a route network analysis layer and sets its analysis properties. A route analysis layer is useful for determining the best route between a set of network locations based on a specified network cost. The Make Route Layer tool is contained in the Network Analyst Tools tool box.

Usage tips:

• After creating the analysis layer with this tool, you can add network analysis objects to it using the tool, solve the analysis using the tool, and save the results on disk using tool.
• When using this tool in geoprocessing models, if the model is run as a tool, the output network analysis layer must be made a model parameter. Otherwise the output layer is not added to the table of contents in ArcMap.

Field Summary

Fields inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool

vals

Constructor Summary

MakeRouteLayer()
Creates the Make Route Layer tool with defaults.

MakeRouteLayer(Object inNetworkDataset, String outNetworkAnalysisLayer, String impedanceAttribute)
Creates the Make Route Layer tool with the required parameters.

Method Summary

Object	getAccumulateAttributeName() Returns the Accumulators parameter of this tool .
String	getFindBestOrder() Returns the Reorder stops to find optimal route parameter of this tool .
String	getHierarchy() Returns the Use hierarchy in analysis parameter of this tool .
Object	getHierarchySettings() Returns the Hierarchy rank settings parameter of this tool .
String	getImpedanceAttribute() Returns the Impedance attribute parameter of this tool .
Object	getInNetworkDataset() Returns the Input analysis network parameter of this tool .
String	getOrderingType() Returns the Preserve ordering of stops parameter of this tool .
String	getOutNetworkAnalysisLayer() Returns the Output layer name parameter of this tool .
Object	getOutputLayer() Returns the Network Analyst Layer parameter of this tool (Read only).
String	getOutputPathShape() Returns the Output path shape parameter of this tool .
Object	getRestrictionAttributeName() Returns the Restrictions parameter of this tool .
Object	getStartDateTime() Returns the Start Time parameter of this tool .
String	getTimeWindows() Returns the Use time windows parameter of this tool .
String	getToolboxAlias() Returns the alias of the tool box containing this tool.
String	getToolboxName() Returns the name of the tool box containing this tool.
String	getToolName() Returns the name of this tool.
String	getUTurnPolicy() Returns the U-turn policy parameter of this tool .
void	setAccumulateAttributeName(Object accumulateAttributeName) Sets the Accumulators parameter of this tool .
void	setFindBestOrder(String findBestOrder) Sets the Reorder stops to find optimal route parameter of this tool .
void	setHierarchy(String hierarchy) Sets the Use hierarchy in analysis parameter of this tool .
void	setHierarchySettings(Object hierarchySettings) Sets the Hierarchy rank settings parameter of this tool .
void	setImpedanceAttribute(String impedanceAttribute) Sets the Impedance attribute parameter of this tool .
void	setInNetworkDataset(Object inNetworkDataset) Sets the Input analysis network parameter of this tool .
void	setOrderingType(String orderingType) Sets the Preserve ordering of stops parameter of this tool .
void	setOutNetworkAnalysisLayer(String outNetworkAnalysisLayer) Sets the Output layer name parameter of this tool .
void	setOutputPathShape(String outputPathShape) Sets the Output path shape parameter of this tool .
void	setRestrictionAttributeName(Object restrictionAttributeName) Sets the Restrictions parameter of this tool .
void	setStartDateTime(Object startDateTime) Sets the Start Time parameter of this tool .
void	setTimeWindows(String timeWindows) Sets the Use time windows parameter of this tool .
void	setUTurnPolicy(String uTurnPolicy) Sets the U-turn policy parameter of this tool .

Methods inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool

getParameterValues, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

MakeRouteLayer

public MakeRouteLayer()

Creates the Make Route Layer tool with defaults.

Initializes the array of tool parameters with the default values specified when the tool was created.

MakeRouteLayer

public MakeRouteLayer(Object inNetworkDataset,
                      String outNetworkAnalysisLayer,
                      String impedanceAttribute)

Creates the Make Route Layer tool with the required parameters.

Initializes the array of tool parameters with the values as specified for the required parameters and with the default values for the other parameters.

Parameters:

inNetworkDataset - the network dataset on which the route analysis will be performed.

outNetworkAnalysisLayer - name of the route network analysis layer to create.

impedanceAttribute - the cost attribute to be used as impedance in the analysis.

Method Detail

getInNetworkDataset

public Object getInNetworkDataset()

Returns the Input analysis network parameter of this tool . This parameter is the network dataset on which the route analysis will be performed. This is a required parameter.

Returns:

the Input analysis network

setInNetworkDataset

public void setInNetworkDataset(Object inNetworkDataset)

Sets the Input analysis network parameter of this tool . This parameter is the network dataset on which the route analysis will be performed. This is a required parameter.

Parameters:

inNetworkDataset - the network dataset on which the route analysis will be performed.

getOutNetworkAnalysisLayer

public String getOutNetworkAnalysisLayer()

Returns the Output layer name parameter of this tool . This parameter is name of the route network analysis layer to create. This is a required parameter.

Returns:

the Output layer name

setOutNetworkAnalysisLayer

public void setOutNetworkAnalysisLayer(String outNetworkAnalysisLayer)

Sets the Output layer name parameter of this tool . This parameter is name of the route network analysis layer to create. This is a required parameter.

Parameters:

outNetworkAnalysisLayer - name of the route network analysis layer to create.

getImpedanceAttribute

public String getImpedanceAttribute()

Returns the Impedance attribute parameter of this tool . This parameter is the cost attribute to be used as impedance in the analysis. This is a required parameter.

Returns:

the Impedance attribute

setImpedanceAttribute

public void setImpedanceAttribute(String impedanceAttribute)

Sets the Impedance attribute parameter of this tool . This parameter is the cost attribute to be used as impedance in the analysis. This is a required parameter.

Parameters:

impedanceAttribute - the cost attribute to be used as impedance in the analysis.

getFindBestOrder

public String getFindBestOrder()

Returns the Reorder stops to find optimal route parameter of this tool . This is an optional parameter.

Returns:

the Reorder stops to find optimal route

setFindBestOrder

public void setFindBestOrder(String findBestOrder)

Sets the Reorder stops to find optimal route parameter of this tool . This is an optional parameter.

Parameters:

findBestOrder - null

getOrderingType

public String getOrderingType()

Returns the Preserve ordering of stops parameter of this tool . This parameter is specifies the ordering of stops when FIND_BEST_ORDER is used. This is an optional parameter.

Returns:

the Preserve ordering of stops

setOrderingType

public void setOrderingType(String orderingType)

Sets the Preserve ordering of stops parameter of this tool . This parameter is specifies the ordering of stops when FIND_BEST_ORDER is used. This is an optional parameter.

Parameters:

orderingType - specifies the ordering of stops when FIND_BEST_ORDER is used.

getTimeWindows

public String getTimeWindows()

Returns the Use time windows parameter of this tool . This parameter is specifies if time windows will be used at the stops. This is an optional parameter.

Returns:

the Use time windows

setTimeWindows

public void setTimeWindows(String timeWindows)

Sets the Use time windows parameter of this tool . This parameter is specifies if time windows will be used at the stops. This is an optional parameter.

Parameters:

timeWindows - specifies if time windows will be used at the stops.

getAccumulateAttributeName

public Object getAccumulateAttributeName()

Returns the Accumulators parameter of this tool . This parameter is list of cost attributes to be accumulated during analysis. These accumulation attributes are purely for reference; the solver only uses the cost attribute specified by the Impedance attribute parameter to calculate the route. for each cost attribute that is accumulated, a Total_[Impedance] property is added to the routes that are output by the solver. This is an optional parameter.

Returns:

the Accumulators

setAccumulateAttributeName

public void setAccumulateAttributeName(Object accumulateAttributeName)

Sets the Accumulators parameter of this tool . This parameter is list of cost attributes to be accumulated during analysis. These accumulation attributes are purely for reference; the solver only uses the cost attribute specified by the Impedance attribute parameter to calculate the route. for each cost attribute that is accumulated, a Total_[Impedance] property is added to the routes that are output by the solver. This is an optional parameter.

Parameters:

accumulateAttributeName - list of cost attributes to be accumulated during analysis. These accumulation attributes are purely for reference; the solver only uses the cost attribute specified by the Impedance attribute parameter to calculate the route. for each cost attribute that is accumulated, a Total_[Impedance] property is added to the routes that are output by the solver.

getUTurnPolicy

public String getUTurnPolicy()

Returns the U-turn policy parameter of this tool . This parameter is restrict or permit U-turns at junctions that could occur during network traversal between stops. This is an optional parameter.

Returns:

the U-turn policy

setUTurnPolicy

public void setUTurnPolicy(String uTurnPolicy)

Sets the U-turn policy parameter of this tool . This parameter is restrict or permit U-turns at junctions that could occur during network traversal between stops. This is an optional parameter.

Parameters:

uTurnPolicy - restrict or permit U-turns at junctions that could occur during network traversal between stops.

getRestrictionAttributeName

public Object getRestrictionAttributeName()

Returns the Restrictions parameter of this tool . This parameter is list of restriction attributes to apply during the analysis. This is an optional parameter.

Returns:

the Restrictions

setRestrictionAttributeName

public void setRestrictionAttributeName(Object restrictionAttributeName)

Sets the Restrictions parameter of this tool . This parameter is list of restriction attributes to apply during the analysis. This is an optional parameter.

Parameters:

restrictionAttributeName - list of restriction attributes to apply during the analysis.

getHierarchy

public String getHierarchy()

Returns the Use hierarchy in analysis parameter of this tool . This parameter is the parameter is not used if a hierarchy attribute is not defined on the network dataset used to perform the analysis. In such cases, use "#" as the parameter value. This is an optional parameter.

Returns:

the Use hierarchy in analysis

setHierarchy

public void setHierarchy(String hierarchy)

Sets the Use hierarchy in analysis parameter of this tool . This parameter is the parameter is not used if a hierarchy attribute is not defined on the network dataset used to perform the analysis. In such cases, use "#" as the parameter value. This is an optional parameter.

Parameters:

hierarchy - the parameter is not used if a hierarchy attribute is not defined on the network dataset used to perform the analysis. In such cases, use "#" as the parameter value.

getHierarchySettings

public Object getHierarchySettings()

Returns the Hierarchy rank settings parameter of this tool . This is an optional parameter.

Returns:

the Hierarchy rank settings

setHierarchySettings

public void setHierarchySettings(Object hierarchySettings)

Sets the Hierarchy rank settings parameter of this tool . This is an optional parameter.

Parameters:

hierarchySettings - null

getOutputPathShape

public String getOutputPathShape()

Returns the Output path shape parameter of this tool . This parameter is specifies the shape type for the route features that are output by the analysis. no matter which output shape type is chosen, the best route is always determined by the network impedance, never Euclidean distance. This means only the route shapes are different, not the underlying traversal of the network. This is an optional parameter.

Returns:

the Output path shape

setOutputPathShape

public void setOutputPathShape(String outputPathShape)

Sets the Output path shape parameter of this tool . This parameter is specifies the shape type for the route features that are output by the analysis. no matter which output shape type is chosen, the best route is always determined by the network impedance, never Euclidean distance. This means only the route shapes are different, not the underlying traversal of the network. This is an optional parameter.

Parameters:

outputPathShape - specifies the shape type for the route features that are output by the analysis. no matter which output shape type is chosen, the best route is always determined by the network impedance, never Euclidean distance. This means only the route shapes are different, not the underlying traversal of the network.

getStartDateTime

public Object getStartDateTime()

Returns the Start Time parameter of this tool . This parameter is specifies a start date and time for the route. Route start time is mostly used to find routes based on the impedance attribute that varies with the time of the day. For example, a start time of 9 AM could be used to find a route that considers the rush hour traffic. The default value for this parameter is 8:00 AM. A date and time can be specified as 10/21/05 10:30 AM. If the route spans multiple days, and only the start time is specified, then the current date is used. instead of using a particular date, a day of the week can be specified using the following dates. for example, to specify that the route should start at 5:00 PM on Tuesday, specify the parameter value as 1/2/1900 5:00 PM. after the solve, the start and end time of the route are populated in the output routes. These start and end times are also used when directions are generated. this option is only valid when a time based cost attribute has been specified as the impedance attribute. This is an optional parameter.

Returns:

the Start Time

setStartDateTime

public void setStartDateTime(Object startDateTime)

Sets the Start Time parameter of this tool . This parameter is specifies a start date and time for the route. Route start time is mostly used to find routes based on the impedance attribute that varies with the time of the day. For example, a start time of 9 AM could be used to find a route that considers the rush hour traffic. The default value for this parameter is 8:00 AM. A date and time can be specified as 10/21/05 10:30 AM. If the route spans multiple days, and only the start time is specified, then the current date is used. instead of using a particular date, a day of the week can be specified using the following dates. for example, to specify that the route should start at 5:00 PM on Tuesday, specify the parameter value as 1/2/1900 5:00 PM. after the solve, the start and end time of the route are populated in the output routes. These start and end times are also used when directions are generated. this option is only valid when a time based cost attribute has been specified as the impedance attribute. This is an optional parameter.

Parameters:

startDateTime - specifies a start date and time for the route. Route start time is mostly used to find routes based on the impedance attribute that varies with the time of the day. For example, a start time of 9 AM could be used to find a route that considers the rush hour traffic. The default value for this parameter is 8:00 AM. A date and time can be specified as 10/21/05 10:30 AM. If the route spans multiple days, and only the start time is specified, then the current date is used. instead of using a particular date, a day of the week can be specified using the following dates. for example, to specify that the route should start at 5:00 PM on Tuesday, specify the parameter value as 1/2/1900 5:00 PM. after the solve, the start and end time of the route are populated in the output routes. These start and end times are also used when directions are generated. this option is only valid when a time based cost attribute has been specified as the impedance attribute.

• Today -- 12/30/1899
• Sunday -- 12/31/1899
• Monday -- 1/1/1900
• Tuesday -- 1/2/1900
• Wednesday -- 1/3/1900
• Thursday -- 1/4/1900
• Friday -- 1/5/1900
• Saturday -- 1/6/1900

getOutputLayer

public Object getOutputLayer()

Returns the Network Analyst Layer parameter of this tool (Read only). This is an derived parameter.

Returns:

the Network Analyst Layer

getToolName

public String getToolName()

Returns the name of this tool.

Returns:

the tool name

getToolboxName

public String getToolboxName()

Returns the name of the tool box containing this tool.

Returns:

the tool box name

getToolboxAlias

public String getToolboxAlias()

Returns the alias of the tool box containing this tool.

Returns:

the tool box alias