com.esri.arcgis.geodatabase
Interface INetworkTurn

All Superinterfaces:

INetworkElement, Serializable

All Known Subinterfaces:

INetworkTurn2

All Known Implementing Classes:

INetworkTurn2Proxy, INetworkTurnProxy, NetworkTurn

public interface INetworkTurn
extends INetworkElement, Serializable

Provides access to members that specify the properties of this network turn.

Remarks

The INetworkTurn interface is used to access the properties of the network turn element, such as its turning angle.

Product Availability

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

Method Summary

double	getAngle() Angle of the turning movement described by this network turn.
int	getEdgeCount() Number of network edge elements that participate in this network turn.
int	getTurnType() Type of network turn.
void	queryAtJunction(INetworkJunction junction) Queries the at-junction of this network turn.
void	queryEdge(int index, INetworkEdge edge) Queries the index'th edge element of this network turn.

Methods inherited from interface com.esri.arcgis.geodatabase.INetworkElement

getAttributeValue, getAttributeValueByName, getEID, getElementType, getOID, getSourceID

Method Detail

getTurnType

int getTurnType()
                throws IOException,
                       AutomationException

Type of network turn.

Remarks

The TurnType property indicates whether or not this NetworkTurn is a turn element in the network.

If the TurnType is esriNTTImplicit, then this NetworkTurn represents an implicit turn. An implicit turn is a turning movement that is implied from two adjacent edge elements where there is no turn element in the network. An implicit turn can only be returned in a NetworkTurn object by the INetworkForwardStarAdjacencies::QueryTurn method.

If the TurnType is esriNTTExplicit, then this NetworkTurn represents a turn element in the network.

Product Availability

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

Returns:

A com.esri.arcgis.geodatabase.esriNetworkTurnType constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryAtJunction

void queryAtJunction(INetworkJunction junction)
                     throws IOException,
                            AutomationException

Queries the at-junction of this network turn.

Remarks

The QueryAtJunction method retrieves the junction element that anchors this turn element. The anchor junction of a turn element is the junction connecting the last two edges that the turn traverses.

This method requires an instantiated NetworkJunction object to be passed in as a parameter. You can create an empty NetworkTurn object by using the INetworkQuery::CreateNetworkElement method.

Product Availability

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

Parameters:

junction - A reference to a com.esri.arcgis.geodatabase.INetworkJunction (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getAngle

double getAngle()
                throws IOException,
                       AutomationException

Angle of the turning movement described by this network turn.

Remarks

The Angle property returns the turning angle of the turn. The turning angle is determined by the difference in the azimuth values of the first and last edge elements of the turn.

The value returned for Angle ranges from 0 to 360. The Angle in measured clockwise from straight in degrees. Below are sample Angle values:

• between 0 and 90 = gentle right turn
• 90 = square right turn
• between 90 and 180 = sharp right turn
• 180 = backtracking turn (U-turn)
• between 180 and 270 = sharp left turn
• 270 = square left turn
• between 270 and 360 = gentle left turn

Product Availability

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

Returns:

The angle

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getEdgeCount

int getEdgeCount()
                 throws IOException,
                        AutomationException

Number of network edge elements that participate in this network turn.

Remarks

The EdgeCount is the number of edge element that this turn traverses.

Product Availability

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

Returns:

The edgeCount

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryEdge

void queryEdge(int index,
               INetworkEdge edge)
               throws IOException,
                      AutomationException

Queries the index'th edge element of this network turn.

Remarks

The QueryEdge method retrieves the edge element traversed by this turn at the specified index. The index values range from 0 to (EdgeCount - 1).

This method requires an instantiated NetworkEdge object to be passed in as a parameter. You can create an empty NetworkEdge object by using the INetworkQuery::CreateNetworkElement method.

Product Availability

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

Parameters:

index - The index (in)

edge - A reference to a com.esri.arcgis.geodatabase.INetworkEdge (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.