方法详细资料

• getID

  public int getID()

  返回该行驶导引子项的 ID。

  除以下三种情形外，该方法均返回 -1：

  • 当行驶导引子项为结点模式下的站点时，站点为结点，返回该结点的结点 ID；
  • 当行驶导引子项为转向点时，转向点为结点，返回该结点的结点 ID；
  • 当行驶导引子项为路段时，返回路段对应的弧段的弧段 ID。如果该路段由多条弧段合并而成，则返回第一条弧段的 ID。

  有关行驶导引子项的类型，请参阅 PathGuideItem 类的介绍。

  返回:

  行驶导引子项的 ID。

• getIndex

  public int getIndex()

  返回该行驶导引子项的序号。

  除以下两种情形外，该方法均返回 -1：

  • 当行驶导引子项为站点时，该值为该站点在所有站点中的序号，从 1 开始。例如某个站点是行驶路线经过的第 2 个站点，则此站点的 Index 值为 2；
  • 当行驶导引子项为转向点时，该值为该点距离上一个转向点或站点的路口数。例如某个转向点之前的两个路口是最近的一个站点，则这个转向点的 Index 值为 2；当某个点同时为站点和转向点时，Index 为在整个行驶过程的所有站点中该站点的位置。

  有关行驶导引子项的类型，请参阅 PathGuideItem 类的介绍。

  返回:

  行驶导引对象子项的序号。

• getName

  public java.lang.String getName()

  返回该行驶导引子项的名称。

  除以下两种情形外，该方法均返回空字符串：

  • 当行驶导引子项为站点（结点模式）或转向点时，该值根据交通网络分析环境中指定的结点名称字段（setNodeNameField）的值给出，如未设置则为空字符串；
  • 当行驶导引子项为路段或站点到网络的线段时，该值根据交通网络分析环境中指定的结点名称字段（setEdgeNameField）的值给出，如未设置则为空字符串。

  有关行驶导引子项的类型，请参阅 PathGuideItem 类的介绍。

  返回:

  行驶导引子项的名称。

• isEdge

  public boolean isEdge()

  返回该行驶导引子项是线还是点类型。若为 true，表示为线类型，如站点到网络的线段、路段；若为 false，表示为点类型，如站点、转向点或站点被归结到网络上的对应点。

  有关行驶导引子项的类型，请参阅 PathGuideItem 类的介绍。

  返回:

  一个布尔值指示该行驶导引子项是线还是点类型。true 代表该行驶导引子项为线类型，否则为点类型。

• isStop

  public boolean isStop()

  返回该行驶导引子项是否为站点，或站点被归结到网络上的对应点。

  当 isStop 返回 true 时，对应的行驶导引子项可能是站点，或当站点为坐标点时，被归结到网络上的对应点，具体介绍请参阅 PathGuideItem 类对行驶导引子项类型的介绍。

  返回:

  一个布尔值指示该行驶导引子项是否为站点或站点在网络上的对应点。true 代表该行驶导引子项为站点或站点在网络上的对应点，否则不是。

• getWeight

  public double getWeight()

  返回该行驶导引子项的权值，即行使导引对象子项的花费。单位与交通网络分析参数（TransportationAnalystParameter）对象的 setWeightName 方法所指定的权值字段信息（WeightFieldInfo）对象的权值字段的单位相同。

  当行驶导引子项为路段、转向点或结点模式下的站点时，得到的花费才有意义，否则均为 0.0。

  • 当行驶导引子项为路段时，根据弧段权值和转向权值计算得出相应的花费。如果未设置转向表，则转向权值为 0；
  • 当行驶导引子项为转向点或结点模式下的站点时（二者均为结点），为相应的转向权值。如果未设置转向表，则为 0.0。

  有关行驶导引子项的类型，请参阅 PathGuideItem 类的介绍。

  返回:

  行驶导引子项的权值。

• getLength

  public double getLength()

  返回该行驶导引子项为线类型（即 isEdge 返回 true}）时，对应线段的长度。单位与用于分析的网络数据集的单位相同。

  仅当 isEdge 返回 true 时，也就是行驶导引子项为路段或站点到网络的线段时，Length 有意义，否则均为 0.0。

  有关行驶导引子项的类型，请参阅 PathGuideItem 类的介绍。

  返回:

  行驶导引子项的长度。

• getTurnAngle

  public double getTurnAngle()

  返回该行驶导引子项为点类型（即 isEdge 返回 false）时，该点处下一步行进的转弯角度。单位为度，精确到 0.1 度。 当 isEdge 返回 true 时，该方法返回 -1。

  有关行驶导引子项的类型，请参阅 PathGuideItem 类的介绍。

  返回:

  行驶导引子项的转弯角度。

• getDistance

  public double getDistance()

  返回站点到网络的距离，仅当行驶导引子项为站点时有效。单位与用于分析的网络数据集的单位相同。

  站点可能不在网络上（既不在弧段上也不在结点上），必须将站点归结到网络上，才能基于网络进行分析。该距离是指站点到最近一条弧段的距离。如下图所示，桔色点代表网络结点，蓝色代表弧段，灰色点为站点，红色线段代表距离。

  

  当行驶导引子项是站点以外的其他类型时，该值为 0.0。

  有关行驶导引子项的类型，请参阅 PathGuideItem 类的介绍。

  返回:

  站点到网络的距离。

• getBounds

  public Rectangle2D getBounds()

  返回该行驶导引子项的范围。仅当行驶导引子项为线类型（即 isEdge 返回 true）时，为线的最小外接矩形；为点类型（即 isEdge 返回 false）时，则为点本身。

  有关行驶导引子项的类型，请参阅 PathGuideItem 类的介绍。

  返回:

  行驶导引子项的范围。

• getDirectionType

  public DirectionType getDirectionType()

  返回该行驶导引子项的行驶方向，仅当行驶导引子项为线类型（即 isEdge 返回 true）时有意义，可以为东、南、西、北。

  当 isEdge 返回 false 时，该方法返回 NONE，即无方向。

  有关行驶导引子项的类型，请参阅 PathGuideItem 类的介绍。

  返回:

  行驶导引子项的行驶方向。

• getTurnType

  public TurnType getTurnType()

  返回该行驶导引子项为点类型（即 isEdge 返回 false）时，该点处下一步行进的转弯方向。

  当 isEdge 返回 true 时，该方法返回 NONE。

  有关行驶导引子项的类型，请参阅 PathGuideItem 类的介绍。

  返回:

  行驶导引子项的转弯方向。

• getSideType

  public SideType getSideType()

  返回该行驶导引子项为站点时，站点在道路的左侧、右侧还是在路上。

  当行驶导引子项为站点以外的类型时，该方法返回 NONE。

  有关行驶导引子项的类型，请参阅 PathGuideItem 类的介绍。

  返回:

  站点的道路的哪一侧。

• getGuideLine

  public GeoLine getGuideLine()

  返回该行驶导引子项为线类型（即 isEdge 返回 true）时，对应的行驶导引线段。

  当 isEdge 返回 false 时，该方法返回 null。

  有关行驶导引子项的类型，请参阅 PathGuideItem 类的介绍。

  返回:

  行驶导引线段。