public class PathGuideItem
extends java.lang.Object
implements java.io.Serializable
行驶导引子项类。
行驶导引记录了如何一步步从起点行驶到终点,其中每一步就是一个行驶导引子项,包括行驶过程中经过的点和弧段, 这些点可以是分析时选取的站点,也可以是分析结果途经的网络结点;弧段可以是网络边,也可能是一条网络边的一部分 (如果分析的站点不在网络结点上)。 利用该类可以对行驶导引对象的子项进行一些设置, 诸如返回子项的 ID、名称、序号、权值等,可以判断子项是点还是弧段,还可以返回行驶方向、转弯方向等等。
限定符和类型 | 字段和说明 |
---|---|
Rectangle2D |
bounds
行驶导引的范围,对弧段而言,为弧段的外接矩形;对点而言,为点本身。
|
java.lang.String |
description
行驶引导描述。
|
DirectionType |
directionType
行驶的方向。
|
double |
distance
站点到弧段的距离。
|
Geometry |
geometry
行驶引导项所对应的地物对象。
|
int |
id
行驶导引对象子项的 ID。
|
int |
index
行驶导引对象子项序号。
|
boolean |
isEdge
判断本行驶导引子项是否是弧段。
|
boolean |
isStop
判断本行驶导引子项是否是站点,即用户输入的用于做路径分析的点, 站点可能与网络结点重合,也可能不在网络上。
|
double |
length
弧段的长度(行驶导引对象子项为弧段时)。
|
java.lang.String |
name
行驶导引对象子项的名称。
|
SideType |
sideType
行驶位置,是在路的左侧、右侧还是在路上。
|
double |
turnAngle
转弯的角度。
|
TurnType |
turnType
转弯的方向。
|
double |
weight
行驶导引对象子项的权值,即行使导引子项的花费。
|
构造器和说明 |
---|
PathGuideItem()
构造函数。
|
PathGuideItem(PathGuideItem pathGuideItem)
拷贝构造函数。
|
public java.lang.String description
行驶引导描述。
public Geometry geometry
行驶引导项所对应的地物对象。
public Rectangle2D bounds
行驶导引的范围,对弧段而言,为弧段的外接矩形;对点而言,为点本身。
public DirectionType directionType
行驶的方向。
共有五个返回值:东、南、西、北、无方向。 当 isEdge 方法返回值为 True 时,directionType 可以为东、南、西、北; 当 isEdge 方法返回值为 False 时,directionType 返回的类型为无方向。
public double distance
站点到弧段的距离。
该距离是指站点到最近一条弧段的距离。如下图所示,桔色点代表网络结点,蓝色代表弧段,灰色点为站点, 红色线段代表距离。举例说明,比如用户希望计算出从家里出发乘坐公交车去医院的最短路程,除了计算出公交线路的最短路程外, 还需要计算出从家走到公交站的最短路程,这个路程就是通过 distance
标识的距离。
public int id
行驶导引对象子项的 ID。子项为弧段时,此值为相应弧段的ID号;子项为网络结点时,此值为相应结点的ID号; 子项为不在网络上的站点时,此值为-1。下图所示为分析得到的站点1到站点2之间的最短路径, 那么站点1位置处作为一个行驶导引子项,它的ID值为-1,下一个行驶导引子项为弧段1,它的ID值为 弧段1的ID值,下一个行驶导引子项为网络结点A,它的ID值为结点A的ID值。
public int index
行驶导引对象子项序号。
public double length
弧段的长度(行驶导引对象子项为弧段时)。
public java.lang.String name
行驶导引对象子项的名称。
public SideType sideType
行驶位置,是在路的左侧、右侧还是在路上。
当 isEdge
为 true 时,返回 SideType.NONE
。
public double turnAngle
转弯的角度。单位为度,精确到0.1度。
public TurnType turnType
public double weight
行驶导引对象子项的权值,即行使导引子项的花费。
public boolean isEdge
判断本行驶导引子项是否是弧段。
true 表示行驶导引子项是弧段,false 表示行驶导引子项不是弧段。
public boolean isStop
判断本行驶导引子项是否是站点,即用户输入的用于做路径分析的点, 站点可能与网络结点重合,也可能不在网络上。
如上图中的站点1,2均不在网络上。true 表示是点,false 表示不是点。
public PathGuideItem(PathGuideItem pathGuideItem)
拷贝构造函数。
pathGuideItem
- 行驶导引子项对象。public PathGuideItem()
构造函数。