com.esri.arcgis.networkanalyst
Interface INAClassLoader2

All Superinterfaces:

INAClassLoader, Serializable

All Known Implementing Classes:

NAClassLoader

public interface INAClassLoader2
extends INAClassLoader, Serializable

Provides access to populate network analysis classes in preparation for analysis.

Remarks

The INAClassLoader2 interface is used, for example, to populate stop locations from a point feature class. It is also used to specify the snapping and reverse-geocoding properties of the NAClassLoader object.

Product Availability

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

Method Summary

ILocator	getAddressLocator() The address locator to be used.
double	getSnapOffsetDistance() The snap offset distance from the network.
int	getSnapOffsetUnits() The snap offset units.
void	initialize(INAContext context, String nAClassName, ICursor cursor) Quickly initializes the class loader to be able to load information from a cursor into a given NAClass.
boolean	isSnapToNetwork() Indicates if the geometry should be snapped to the network.
void	setAddressLocatorByRef(ILocator addressLocator) The address locator to be used.
void	setSnapOffsetDistance(double distance) The snap offset distance from the network.
void	setSnapOffsetUnits(int units) The snap offset units.
void	setSnapToNetwork(boolean enabled) Indicates if the geometry should be snapped to the network.

Methods inherited from interface com.esri.arcgis.networkanalyst.INAClassLoader

getFieldMap, getLocator, getNAClass, load, setFieldMapByRef, setLocatorByRef, setNAClassByRef

Method Detail

initialize

void initialize(INAContext context,
                String nAClassName,
                ICursor cursor)
                throws IOException,
                       AutomationException

Quickly initializes the class loader to be able to load information from a cursor into a given NAClass.

Remarks

The INAClassLoader2::Initialize method sets the Locator, NAClass, and FieldMap properties otherwise set via methods on the INAClassLoader interface.

Product Availability

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

Parameters:

context - A reference to a com.esri.arcgis.networkanalyst.INAContext (in)

nAClassName - The nAClassName (in)

cursor - A reference to a com.esri.arcgis.geodatabase.ICursor (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setAddressLocatorByRef

void setAddressLocatorByRef(ILocator addressLocator)
                            throws IOException,
                                   AutomationException

The address locator to be used.

Remarks

The AddressLocator property specifies the ILocator address locator used to determine the name of the network location based on reverse geocoding of the network location's geometry.

Product Availability

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

Parameters:

addressLocator - A reference to a com.esri.arcgis.geodatabase.ILocator (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getAddressLocator

ILocator getAddressLocator()
                           throws IOException,
                                  AutomationException

The address locator to be used.

Remarks

The AddressLocator property specifies the ILocator address locator used to determine the name of the network location based on reverse geocoding of the network location's geometry.

Product Availability

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

Returns:

A reference to a com.esri.arcgis.geodatabase.ILocator

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setSnapToNetwork

void setSnapToNetwork(boolean enabled)
                      throws IOException,
                             AutomationException

Indicates if the geometry should be snapped to the network.

Remarks

SnapToNetwork specifies if the network location's geometry should be a snapped to where it lies on the network dataset during load.

Specify the SnapOffsetDistance and SnapOffsetUnits if you want the network location offset a fixed difference from the true snap location. This is useful if you care about the side of the road the network location is on.

Product Availability

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

Parameters:

enabled - The enabled (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isSnapToNetwork

boolean isSnapToNetwork()
                        throws IOException,
                               AutomationException

Indicates if the geometry should be snapped to the network.

Remarks

SnapToNetwork specifies if the network location's geometry should be snapped to where it lies on the network dataset during load.

Specify the SnapOffsetDistance and SnapOffsetUnits if you want the network location offset a fixed difference from the true snap location. This is useful if you care about the side of the road the network location is on.

Product Availability

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

Returns:

The enabled

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setSnapOffsetDistance

void setSnapOffsetDistance(double distance)
                           throws IOException,
                                  AutomationException

The snap offset distance from the network.

Remarks

Specify the SnapOffsetDistance and SnapOffsetUnits if you want the network location offset a fixed difference from the true snap location. This is useful if you care about the side of the road the network location is on.

This is only applicable if SnapToNetwork is true.

Product Availability

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

Parameters:

distance - The distance (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSnapOffsetDistance

double getSnapOffsetDistance()
                             throws IOException,
                                    AutomationException

The snap offset distance from the network.

Remarks

Specify the SnapOffsetDistance and SnapOffsetUnits if you want the network location offset a fixed difference from the true snap location. This is useful if you care about the side of the road the network location is on.

This is only applicable if SnapToNetwork is true.

Product Availability

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

Returns:

The distance

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setSnapOffsetUnits

void setSnapOffsetUnits(int units)
                        throws IOException,
                               AutomationException

The snap offset units.

Remarks

Specify the SnapOffsetDistance and SnapOffsetUnits if you want the network location offset a fixed difference from the true snap location. This is useful if you care about the side of the road the network location is on.

This is only applicable if SnapToNetwork is true.

Product Availability

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

Parameters:

units - A com.esri.arcgis.system.esriUnits constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSnapOffsetUnits

int getSnapOffsetUnits()
                       throws IOException,
                              AutomationException

The snap offset units.

Remarks

Specify the SnapOffsetDistance and SnapOffsetUnits if you want the network location offset a fixed difference from the true snap location. This is useful if you care about the side of the road the network location is on.

This is only applicable if SnapToNetwork is true.

Product Availability

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

Returns:

A com.esri.arcgis.system.esriUnits constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.