com.supermap.analyst.trafficanalyst
类 RelationSetting

java.lang.Object
  com.supermap.analyst.trafficanalyst.RelationSetting

public class RelationSetting
extends java.lang.Object

公交关系设置类。通过该类可以设置站点与线路关系数据集、站点与出入口关系数据集以及网络数据集的相关信息。

公交分析的基础数据中，除站点数据集和线路数据集外，还有两个重要的数据集：站点与线路关系数据集和站点与出入口数据集。

• 站点与线路关系数据集，是一个纯属性表（DatasetType.TABULAR）类型的数据集，用于确定站点与线路的关系。现实中的公共交通，尤其是公交车，存在大量经过某站点而不停车的情况。单纯依靠将站点数据（二维点）捕捉到线路数据（二维线）上，不仅可能与实际情况不符，甚至可能导致分析结果错误，给使用者和出行者带来不必要的损失。因此，通过一个准确的站点与线路关系表就可以避免这种问题出现。

表中除系统字段外还必须包含用于标识线路的线路 ID 和用于标识站点的站点 ID 字段，还可以包含站点在对应线路中为第几站的字段。通过线路 ID 和站点 ID 的对应，可以明确站点与线路的关系，即线路包含哪些站点，是进行公交分析的基础。

• 站点与出入口数据集，是一个二维线数据集，每一个线对象连接一个站点和一个出入口，用于表示站点与出入口间的实际线路。该数据是可选数据，如果设置了该数据，则换乘方案中给出的站点与出入口间的行进线路与该数据对应，如果不设置，站点与出入口间以直线连接。该数据能够保障公交换乘线路与实际保持一致，从而为出行者提供更加准确的换乘信息，如路线、总长度、时间花费等。

该数据集的属性表中除系统字段外还必须包含用于标识站点的站点 ID 和用于标识出入口的出入口 ID 字段，还可以包含出入口的中文名称和拼音字段。

注意，该数据中的线对象没有方向，即从 A 到 B 与 从 B 到 A 为一条线。

注意：站点 ID 字段、出入口 ID 字段 和线路 ID 字段的类型目前仅支持32位整型和64位整型。

示例:

请参见 TransferAnalyst 类的 load 方法的示例。

构造方法摘要

RelationSetting()
构造一个新的 RelationSetting 对象。

RelationSetting(RelationSetting relationSetting)
根据给定的 RelationSetting 对象构造一个与其完全相同的的新对象。

方法摘要

DatasetVector	getDataset() 返回站点与线路关系数据集。
DatasetVector	getDatasetNetwork() 返回网络数据集。
DatasetVector	getDatasetPath() 返回站点与出入口关系数据集。
java.lang.String	getEdgeIDField() 返回网络数据集中的弧段 ID 字段。
java.lang.String	getExitIDField() 返回站点与出入口关系数据集中的出入口 ID 字段。
java.lang.String	getExitNameCField() 返回站点与出入口关系数据集中的出入口中文名称字段。
java.lang.String	getExitNamePYField() 返回站点与出入口关系数据集中的出入口名称拼音字段。
java.lang.String	getFNodeIDField() 返回网络数据集中的弧段起始结点 ID 的字段。
java.lang.String	getLineIDField() 返回设置站点与线路关系数据集中的线路 ID 字段。
java.lang.String	getNodeIDField() 返回网络数据集中的结点 ID 字段。
java.lang.String	getSerialNumField() 返回站点与线路关系数据集中存储了站点在线路中的顺序号（即该站点为线路中的第几站）的字段。
java.lang.String	getStationIDField() 返回站点与出入口关系数据集中的站点 ID 字段。
java.lang.String	getStopIDField() 返回站点与线路关系数据集中的站点 ID 字段。
java.lang.String	getTNodeIDField() 返回网络数据集中的弧段终止结点 ID 的字段。
void	setDataset(DatasetVector datasetVector) 设置站点与线路关系数据集。
void	setDatasetNetwork(DatasetVector value) 设置网络数据集。
void	setDatasetPath(DatasetVector value) 设置站点与出入口关系数据集。
void	setEdgeIDField(java.lang.String value) 设置网络数据集中的弧段 ID 字段。
void	setExitIDField(java.lang.String value) 设置站点与出入口关系数据集中的出入口 ID 字段。
void	setExitNameCField(java.lang.String value) 设置站点与出入口关系数据集中的出入口中文名称字段。
void	setExitNamePYField(java.lang.String value) 设置站点与出入口关系数据集中的出入口名称拼音字段。
void	setFNodeIDField(java.lang.String value) 设置网络数据集中的弧段起始结点 ID 的字段。
void	setLineIDField(java.lang.String value) 设置站点与线路关系数据集中的线路 ID 字段。
void	setNodeIDField(java.lang.String value) 设置网络数据集中的结点 ID 字段。
void	setSerialNumField(java.lang.String value) 设置站点与线路关系数据集中存储了站点在线路中的顺序号（即该站点为线路中的第几站）的字段。
void	setStationIDField(java.lang.String value) 设置站点与出入口关系数据集中的站点 ID 字段。
void	setStopIDField(java.lang.String value) 设置站点与线路关系数据集中的站点 ID 字段。
void	setTNodeIDField(java.lang.String value) 设置网络数据集中的弧段终止结点 ID 的字段。

从类 java.lang.Object 继承的方法

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

RelationSetting

public RelationSetting()

构造一个新的 RelationSetting 对象。

RelationSetting

public RelationSetting(RelationSetting relationSetting)

根据给定的 RelationSetting 对象构造一个与其完全相同的的新对象。

参数：

relationSetting - 指定的 RelationSetting 对象。

方法详细信息

getDataset

public DatasetVector getDataset()

返回站点与线路关系数据集。

详细介绍请参见 setDataset 方法。

返回：

站点与线路关系数据集。

setDataset

public void setDataset(DatasetVector datasetVector)

设置站点与线路关系数据集。要求数据集类型为纯属性表类型。如果未设置或指定的数据集类型为其他类型，将抛出异常。

公交站点与线路关系数据集，是进行公交分析的基础数据，如果不存在该数据集，公交站点数据集和公交线路数据集中的站点数据与线路数据的所属关系不能准确确定。

参数：

datasetVector - 站点与线路关系数据集。

getStopIDField

public java.lang.String getStopIDField()

返回站点与线路关系数据集中的站点 ID 字段。

详细介绍请参见 setStopIDField 方法。

返回：

站点与线路关系数据集中的站点 ID 字段。

默认值:

默认值为一个空的字符串。

setStopIDField

public void setStopIDField(java.lang.String value)

设置站点与线路关系数据集中的站点 ID 字段。该字段为必设字段，要求字段类型为32位整型或64位整型。如果站点与线路关系数据集中不存在该字段或字段类型不匹配，将抛出异常。

站点 ID 字段是公交站点的唯一标识值。站点与线路关系数据集中该字段的值应与公交站点数据集中的站点 ID 字段的值范围一致。

参数：

value - 站点与线路关系数据集中的站点 ID 字段。

getLineIDField

public java.lang.String getLineIDField()

返回设置站点与线路关系数据集中的线路 ID 字段。

详细介绍请参见 setLineIDField 方法。

返回：

站点与线路关系数据集中的线路 ID 字段。

默认值:

默认值为一个空的字符串。

setLineIDField

public void setLineIDField(java.lang.String value)

设置站点与线路关系数据集中的线路 ID 字段。该字段为必设字段，要求字段类型为32位整型或64位整型。如果站点与线路关系数据集中不存在该字段或字段类型不匹配，将抛出异常。

线路 ID 字段是公交线路的唯一标识值。站点与线路关系数据集中该字段的值应与公交线路数据集中的线路 ID 字段的值范围一致。

参数：

value - 站点与线路关系数据集中的线路 ID 字段。

getSerialNumField

public java.lang.String getSerialNumField()

返回站点与线路关系数据集中存储了站点在线路中的顺序号（即该站点为线路中的第几站）的字段。

详细介绍请参见 setSerialNumField 方法。

返回：

站点与线路关系数据集中存储了站点在线路中的顺序号的字段。

默认值:

默认值为一个空的字符串。

setSerialNumField

public void setSerialNumField(java.lang.String value)

设置站点与线路关系数据集中存储了站点在线路中的顺序号（即该站点为线路中的第几站）的字段。

站点在线路中的顺序号，即为该站点在线路中是第几站，其中起始站点为第 1 站。当使用按站数计价方式（在设置公交线路环境时，可以设置线路的票价信息，参见 setFareFieldInfo）时，知道了某条换乘线路的上车和下车站点在线路中的顺序号后，再结合票价信息就可以计算出这段距离的公交票价，进一步可以获取整个换乘方案总的公交票价。

参数：

value - 站点与线路关系数据集中存储了站点在线路中的顺序号的字段。

getDatasetPath

public DatasetVector getDatasetPath()

返回站点与出入口关系数据集。

详细介绍请参见 setDatasetPath 方法。

返回：

站点与出入口线路数据集。

setDatasetPath

public void setDatasetPath(DatasetVector value)

设置站点与出入口关系数据集。要求数据集类型为线数据集。如果指定的数据集类型为其他类型，将抛出异常。

该数据集是一个二维线数据集，存储了从站点到出入口的实际行进路线，通过实际测量或数字化获得。线对象的两个端点分别连接一个站点和一个出入口站点。在公交换乘分析结果的换乘方案中，站点和出入口间的路线将根据该数据来给出。注意，该数据不是必须设置的数据，如果不指定该数据集，则公交换乘分析结果中，站点与出入口间以直线连接。

参数：

value - 站点与线路关系数据集。

getExitIDField

public java.lang.String getExitIDField()

返回站点与出入口关系数据集中的出入口 ID 字段。

返回：

出入口 ID 字段。

默认值:

默认值为一个空的字符串。

setExitIDField

public void setExitIDField(java.lang.String value)

设置站点与出入口关系数据集中的出入口 ID 字段。该字段为必设字段，要求字段类型为32位整型或64位整型。如果站点与线路关系数据集中不存在该字段或字段类型不匹配，将抛出异常。

参数：

value - 出入口 ID 字段。

getStationIDField

public java.lang.String getStationIDField()

返回站点与出入口关系数据集中的站点 ID 字段。

返回：

站点 ID 字段。

默认值:

默认值为一个空的字符串。

setStationIDField

public void setStationIDField(java.lang.String value)

设置站点与出入口关系数据集中的站点 ID 字段。该字段为必设字段，要求字段类型为32位整型或64位整型。如果站点与线路关系数据集中不存在该字段或字段类型不匹配，将抛出异常。

参数：

value - 站点 ID 字段。

getExitNameCField

public java.lang.String getExitNameCField()

返回站点与出入口关系数据集中的出入口中文名称字段。

返回：

出入口中文名称字段。

默认值:

默认值为一个空的字符串。

setExitNameCField

public void setExitNameCField(java.lang.String value)

设置站点与出入口关系数据集中的出入口中文名称字段。

参数：

value - 出入口中文名称字段。

getExitNamePYField

public java.lang.String getExitNamePYField()

返回站点与出入口关系数据集中的出入口名称拼音字段。

返回：

出入口名称拼音字段。

默认值:

默认值为一个空的字符串。

setExitNamePYField

public void setExitNamePYField(java.lang.String value)

设置站点与出入口关系数据集中的出入口名称拼音字段。

参数：

value - 出入口名称拼音字段。

getDatasetNetwork

public DatasetVector getDatasetNetwork()

返回网络数据集。根据网络数据集的弧段和结点信息来获取换乘时的实际步行路线。

返回：

网络数据集。

setDatasetNetwork

public void setDatasetNetwork(DatasetVector value)

设置网络数据集。根据网络数据集的弧段和结点信息来获取换乘时的实际步行路线。

网络数据集不是必须设置的数据，如果不设置，换乘时的路线为连接换乘起点和终点的一条直线。

参数：

value - 网络数据集。

getEdgeIDField

public java.lang.String getEdgeIDField()

返回网络数据集中的弧段 ID 字段。

返回：

网络数据集中的弧段 ID 字段。

默认值:

默认值为一个空的字符串。

setEdgeIDField

public void setEdgeIDField(java.lang.String value)

设置网络数据集中的弧段 ID 字段。

参数：

value - 网络数据集中的弧段 ID 字段。

getNodeIDField

public java.lang.String getNodeIDField()

返回网络数据集中的结点 ID 字段。

返回：

网络数据集中的结点 ID 字段。

默认值:

默认值为一个空的字符串。

setNodeIDField

public void setNodeIDField(java.lang.String value)

设置网络数据集中的结点 ID 字段。

参数：

value - 网络数据集中的结点 ID 字段。

getFNodeIDField

public java.lang.String getFNodeIDField()

返回网络数据集中的弧段起始结点 ID 的字段。

返回：

网络数据集中的弧段起始结点 ID 的字段。

默认值:

默认值为一个空的字符串。

setFNodeIDField

public void setFNodeIDField(java.lang.String value)

设置网络数据集中的弧段起始结点 ID 的字段。

参数：

value - 网络数据集中的弧段起始结点 ID 的字段。

getTNodeIDField

public java.lang.String getTNodeIDField()

返回网络数据集中的弧段终止结点 ID 的字段。

返回：

网络数据集中的弧段终止结点 ID 的字段。

默认值:

默认值为一个空的字符串。

setTNodeIDField

public void setTNodeIDField(java.lang.String value)

设置网络数据集中的弧段终止结点 ID 的字段。

参数：

value - 网络数据集中的弧段终止结点 ID 的字段。