com.esri.arcgis.datasourcesfile
Class SMStop

java.lang.Object
  extended by 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.