com.esri.arcgis.datasourcesfile
Class SMStop

java.lang.Object
  com.esri.arcgis.datasourcesfile.SMStop

All Implemented Interfaces:

ISMStop, com.esri.arcgis.interop.RemoteObjRef, Serializable

public class SMStop
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, ISMStop

The information about route stop.

Product Availability

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

See Also:

Serialized Form

Constructor Summary

SMStop()
Constructs a SMStop using ArcGIS Engine.

SMStop(Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
SMStop theSMStop = (SMStop) obj;

Method Summary

boolean	equals(Object o) Compare this object with another
static String	getClsid() getClsid.
String	getDescription() Descriptive text of the route stop used in driving directions.
short	getDuration() Stop duration in minutes.
ISMFlag	getFlag() The SMFlag object of the stop that describes its geographic location.
double	getMinDistanceToTurn() Minimal allowed distance to turn.
int	getStopID() Numeric identifier of the user defined route stop.
int	hashCode() the hashcode for this object
boolean	isEnforceSideOfStreet() Indicates whether shortest path is restricted when traveling to and from the given stop.
void	setDescription(String pVal) Descriptive text of the route stop used in driving directions.
void	setDuration(short pVal) Stop duration in minutes.
void	setEnforceSideOfStreet(boolean pbESS) Indicates whether shortest path is restricted when traveling to and from the given stop.
void	setFlag(ISMFlag pVal) The SMFlag object of the stop that describes its geographic location.
void	setMinDistanceToTurn(double pdDist) Minimal allowed distance to turn.
void	setStopID(int pVal) Numeric identifier of the user defined route stop.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef

getJintegraDispatch, release

Constructor Detail

SMStop

public SMStop()
       throws IOException,
              UnknownHostException

Constructs a SMStop using ArcGIS Engine.

Throws:

IOException - if there are interop problems

UnknownHostException - if there are interop problems

SMStop

public SMStop(Object obj)
       throws IOException

Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
SMStop theSMStop = (SMStop) obj;

Construct a SMStop using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to SMStop.

Parameters:

obj - an object returned from ArcGIS Engine or Server

Throws:

IOException - if there are interop problems

Method Detail

getClsid

public static String getClsid()

getClsid.

equals

public boolean equals(Object o)

Compare this object with another

Overrides:

equals in class Object

hashCode

public int hashCode()

the hashcode for this object

Overrides:

hashCode in class Object

getStopID

public int getStopID()
              throws IOException,
                     AutomationException

Numeric identifier of the user defined route stop.

Description

Represents the numeric user-defined stop identifier.

Product Availability

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

Specified by:

getStopID in interface ISMStop

Returns:

The pVal

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setStopID

public void setStopID(int pVal)
               throws IOException,
                      AutomationException

Numeric identifier of the user defined route stop.

Description

Sets the numeric user-defined stop identifier.

Product Availability

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

Specified by:

setStopID in interface ISMStop

Parameters:

pVal - The pVal (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDescription

public String getDescription()
                      throws IOException,
                             AutomationException

Descriptive text of the route stop used in driving directions.

Description

Returns the description text of the stop.

Product Availability

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

Specified by:

getDescription in interface ISMStop

Returns:

The pVal

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setDescription

public void setDescription(String pVal)
                    throws IOException,
                           AutomationException

Descriptive text of the route stop used in driving directions.

Description

Sets the description text of the stop.

Product Availability

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

Specified by:

setDescription in interface ISMStop

Parameters:

pVal - The pVal (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getFlag

public ISMFlag getFlag()
                throws IOException,
                       AutomationException

The SMFlag object of the stop that describes its geographic location.

Description

Returns the ISMFlag interface of the stop.

Product Availability

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

Specified by:

getFlag in interface ISMStop

Returns:

A reference to a com.esri.arcgis.datasourcesfile.ISMFlag

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setFlag

public void setFlag(ISMFlag pVal)
             throws IOException,
                    AutomationException

The SMFlag object of the stop that describes its geographic location.

Description

Sets the ISMFlag interface of the stop.

Product Availability

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

Specified by:

setFlag in interface ISMStop

Parameters:

pVal - A reference to a com.esri.arcgis.datasourcesfile.ISMFlag (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDuration

public short getDuration()
                  throws IOException,
                         AutomationException

Stop duration in minutes.

Description

Returns stop duration in minutes.

Product Availability

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

Specified by:

getDuration in interface ISMStop

Returns:

The pVal

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setDuration

public void setDuration(short pVal)
                 throws IOException,
                        AutomationException

Stop duration in minutes.

Description

Sets stop duration in minutes.

Product Availability

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

Specified by:

setDuration in interface ISMStop

Parameters:

pVal - The pVal (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMinDistanceToTurn

public double getMinDistanceToTurn()
                            throws IOException,
                                   AutomationException

Minimal allowed distance to turn.

Description

Returns the minimum allowed distance to turn.

Remarks

This value is used to indicate how SMRouter should handle the first turn of each route leg. The Router generates the shortest path route in a way that the first turn does not appear within the MinDistanceToTurn specified in miles, unless a turn is required to proceed based on the current direction of travel (i.e. road ends, fork in the road, etc.) In the scenario where a turn is required, the route is generated from the street that has the least turn angle from the preceding street. In the case where turn angles are within 10° of each other, these are considered equal turn angles, and the route is generated from the intersection that is being traveled through.

Product Availability

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

Specified by:

getMinDistanceToTurn in interface ISMStop

Returns:

The pdDist

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setMinDistanceToTurn

public void setMinDistanceToTurn(double pdDist)
                          throws IOException,
                                 AutomationException

Minimal allowed distance to turn.

Description

Sets the minimal allowed distance for a turn.

Remarks

This value is used to indicate how SMRouter should handle the first turn of each route leg. The Router generates the shortest path route in a way that the first turn does not appear within the MinDistanceToTurn specified in miles, unless a turn is required to proceed based on the current direction of travel (i.e. road ends, fork in the road, etc.) In the scenario where a turn is required, the route is generated from the street that has the least turn angle from the preceding street. In the case where turn angles are within 10° of each other, these are considered equal turn angles, and the route is generated from the intersection that is being traveled through.

Product Availability

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

Specified by:

setMinDistanceToTurn in interface ISMStop

Parameters:

pdDist - The pdDist (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isEnforceSideOfStreet

public boolean isEnforceSideOfStreet()
                              throws IOException,
                                     AutomationException

Indicates whether shortest path is restricted when traveling to and from the given stop.

Description

Enforces street side at the stop. Returns the street side.

Remarks

If this value is set to true, the shortest path is restricted when traveling to and from the given stop. The restriction is that the shortest path can enter the street from only one end-point and exit from the other, depending on which side of the street the stop is located. If the flag is not set, the shortest path can enter the street in either direction. Unless otherwise specified by the caller, the default value for this flag is false.

Note: If the street is one-way, the shortest path always enters the street in the correct direction.

Product Availability

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

Specified by:

isEnforceSideOfStreet in interface ISMStop

Returns:

The pbESS

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setEnforceSideOfStreet

public void setEnforceSideOfStreet(boolean pbESS)
                            throws IOException,
                                   AutomationException

Indicates whether shortest path is restricted when traveling to and from the given stop.

Description

Enforces street side at the stop. Sets the street side.

Remarks

If this value is set to true, the shortest path is restricted when traveling to and from the given stop. The restriction is that the shortest path can enter the street from only one end-point and exit from the other, depending on which side of the street the stop is located. If the flag is not set, the shortest path can enter the street in either direction. Unless otherwise specified by the caller, the default value for this flag is false.

Note: If the street is one-way, the shortest path always enters the street in the correct direction.

Product Availability

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

Specified by:

setEnforceSideOfStreet in interface ISMStop

Parameters:

pbESS - The pbESS (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.