沿路径定位要素 (线性参考工具)

汇总

计算输入要素（点、线或面）与路径要素的交集，并将路径和测量信息写入新的事件表。

了解有关事件表的详细信息

用法

• 当输入要素参数值为点时，事件类型值必须设置为点。 当输入要素参数值为线或面时，事件类型值必须设置为线。

• 在输入要素与目标路径精确重叠时可取得最佳结果。

  注意：

  如果使用较大的搜索半径或聚类容差克服输入要素与目标路径之间的偏差，则可能产生意想不到的结果。

• 要减少此工具处理的输入要素的数量，可以输入能够执行选择操作的图层。

• 可使用创建路径事件图层工具将输出表显示在地图中。

参数

• Dialog
• Python

标注	说明	数据类型
输入要素	输入点、线或面要素。	Feature Layer
输入路径要素	将与输入要素参数值相交的路径。	Feature Layer
路径标识符字段	包含可唯一识别每条路径的值的字段。 此字段可以是数值、文本或 GUID 字段。	Field
搜索半径	如果输入要素参数值是点，则搜索半径是数值，定义可在每个点周围的多大范围内执行搜索以找到目标路径。 如果输入要素参数值是线，则搜索容差是聚类容差，即表示输入线与目标路径之间的最大容许距离的数值。 如果输入要素参数值是面，则忽略此参数且不使用搜索半径。	Linear Unit
输出事件表	要创建的表。 输出表可以是 dBase（.dbf 文件）或地理数据库表。	Table
输出事件表属性	将写入输出事件表的路径位置字段和事件类型。 路径标识符字段—该字段将包含指示每个事件所在路径的值。 此字段可以是数值、文本或 GUID 字段。 事件类型—输出事件表中将包含的事件类型（点或线）。 点—点事件出现在沿路径的确切点位置处。 仅可指定只有单一测量字段。 线—线事件定义路径的一部分。 “测量始于”和“测量止于”都是必须指定的字段。 测量始于字段—将包含测量值的字段。 当事件类型是点或线时，此字段为必填字段。 在事件类型值为点时，此参数的标注将变为测量字段。 测量止于字段—将包含测量值的字段。 当事件类型是线时，此字段为必填字段。	Route Measure Event Properties
仅保留最近的路径位置 （可选）	指定是否将最近的路线位置或搜索半径内的每个路线位置写入输出事件表参数值。 在沿路线定位点时，任何给定点的搜索半径内可能有不止一条路线。 沿路径定位线或面时将忽略此参数。 选中—只将最近的路径位置写入输出事件表参数值。 这是默认设置。 未选中—将每个路径位置（搜索半径范围内）都写入输出事件表参数值。	Boolean
在输出表中包括距离字段 （可选）	指定是否将 DISTANCE 字段添加到输出事件表参数值。 此字段中的值以指定的搜索半径为单位。 沿路径定位线或面时将忽略此参数。 选中—将包含点到路径距离的字段添加到输出事件表参数值。 这是默认设置。 未选中—不会将包含点到路径距离的字段添加到输出事件表参数值。	Boolean
保留零长度线事件 （可选）	指定是否将零长度线事件写入输出。 当沿路线定位面时，可能会创建其中“测量始于”等于“测量止于”的事件。 沿路径定位点或线时将忽略此参数。 选中—将零长度线事件写入输出事件表参数值。 这是默认设置。 未选中—不会将零长度线事件写入输出事件表参数值。	Boolean
包括输入的所有字段 （可选）	指定输出事件表参数值是否包含路径位置字段以及所有来自输入要素参数值的所有属性。 选中—输出事件表参数值将包含路径位置字段以及所有来自输入要素参数值的所有属性。 这是默认设置。 未选中—输出事件表参数值将仅包含路径位置字段以及来自输入要素参数值的 ObjectID 字段。	Boolean
使用 M 方向偏移 （可选）	指定计算的偏移距离是基于 m 方向还是数字化方向。 如果选中输出表包括距离字段参数，则距离将包含在输出事件表参数值中。 选中—将根据路径的 M 方向计算输出事件表参数值中的距离值。 位于路径 M 方向左侧的输入要素将被赋予正 (+) 偏移，位于 M 方向右侧的要素将被赋予负 (-) 偏移。 这是默认设置。 未选中—将根据路径的数字化方向计算输出事件表参数值中的距离值。 位于路径数字化方向左侧的输入要素将被赋予负 (-) 偏移，位于路径数字化方向右侧的要素将被赋予正 (+) 偏移。	Boolean

环境

当前工作空间, 输出配置关键字, 范围, 临时工作空间

许可信息

• 基本: 是
• 标准: 是
• 高级: 是

相关主题

• 线性参考工具箱概览
• 查找地理处理工具