基于现有数据集创建 LRS 交叉点 (位置参考)

摘要

将现有交叉点要素类注册为交叉点。

使用情况

• 相交要素类的投影坐标系必须与父 LRS 网络参数值的坐标系相匹配。

• 父 LRS 网络参数值可用作相交图层，因此生成的交叉点将位于网络中的路径之间。

• 父 LRS 网络参数值不能是要素服务。

• 交叉点要素类参数值和相交图层必须与父 LRS 网络参数值位于同一地理数据库中。

• 通过将网络描述字段参数值与相交图层参数中的描述字段值串连来创建交叉点名称，并使用相交图层参数中的名称分隔符值分隔。

• 交叉点要素类字段必须包含 LRS 数据模型中列出的属性。

• 相交图层参数值必须启用 z 值。

参数

对话框

标注	说明	数据类型
父 LRS 网络	交叉点将注册到的网络。	Feature Layer
网络描述字段	网络图层中的字段，用于命名与其他相交图层的交叉点。	Field
交叉点要素类	要注册的输入点要素类。	Feature Layer
交叉点 ID 字段	交叉点要素类参数值中的 ID 字段。 该字段必须具有对于时间片的每个交叉点的唯一 ID。	Field
交叉点名称字段	交叉点要素类参数值中的字段，是用于显示路径和相交要素描述符的串连字段。	Field
路径 ID 字段	交叉点要素类参数值中包含 LRS 网络的路径 ID 的字段。	Field
要素 ID 字段	交叉点要素类参数值中包含相交要素 ID 的字段。	Field
要素类字段名称	交叉点要素类参数值中包含参与交叉点的要素类名称的字段。	Field
开始日期字段	交叉点要素类参数值中的开始日期字段。	Field
结束日期字段	交叉点要素类参数值中的结束日期字段。	Field
相交图层	与 LRS 网络相交并包含以下信息的要素类： 交叉点图层 - 与 LRS 网络相交的要素类。 ID 字段 - 相交图层中用于唯一识别与网络相交的要素的字段。 描述字段 - 提供相交要素的描述（例如镇或县名称）的字段。 名称分隔符 - 交叉点的名称分隔符，例如 AND、INTERSECT、+ 或 |。	Value Table
在生成交叉点时，请考虑 z 值 (可选)	指定生成交叉点时是否使用 z 值。 选中 - 将在交叉点生成期间使用 Z 值。 未选中 - 在交叉点生成期间不会使用 Z 值。 这是默认设置。	Boolean
Z 容差	用于生成交叉点的 z 容差。	Double
测量字段	交叉点处基本路径上的测量值。	Field

派生输出

标注	说明	数据类型
输出详细信息文件	详细说明对交叉点要素类参数值所做更改的输出要素类。	Feature Class

Python

arcpy.locref.CreateLRSIntersectionFromExistingDataset(parent_network, network_description_field, in_feature_class, intersection_id_field, intersection_name_field, route_id_field, feature_id_field, feature_class_name_field, from_date_field, to_date_field, intersecting_layers, {consider_z}, z_tolerance, measure_field)

名称	说明	数据类型
parent_network	交叉点将注册到的网络。	Feature Layer
network_description_field	网络图层中的字段，用于命名与其他相交图层的交叉点。	Field
in_feature_class	要注册的输入点要素类。	Feature Layer
intersection_id_field	in_feature_class 参数值中的 ID 字段。 该字段必须具有对于时间片的每个交叉点的唯一 ID。	Field
intersection_name_field	in_feature_class 参数值中的字段是一个串联字段，显示路径和相交要素的描述符。	Field
route_id_field	in_feature_class 参数值中的字段包含 LRS 网络的路由 ID。	Field
feature_id_field	in_feature_class 参数值中包含相交要素 ID 的字段。	Field
feature_class_name_field	in_feature_class 参数值中包含参与交叉点的要素类名称的字段。	Field
from_date_field	in_feature_class 参数值中的起始日期字段。	Field
to_date_field	in_feature_class 参数值中的结束日期字段。	Field
intersecting_layers [intersecting_layers,...]	与 LRS 网络相交并包含以下信息的要素类： 交叉点图层 - 与 LRS 网络相交的要素类。 ID 字段 - 相交图层中用于唯一识别与网络相交的要素的字段。 描述字段 - 提供相交要素的描述（例如镇或县名称）的字段。 名称分隔符 - 交叉点的名称分隔符，例如 AND、INTERSECT、+ 或 |。	Value Table
consider_z (可选)	指定生成交叉点时是否使用 z 值。 CONSIDER_Z—将在交叉点生成期间使用 Z 值。 DO_NOT_CONSIDER_Z—在交叉点生成期间不会使用 Z 值。 这是默认设置。	Boolean
z_tolerance	用于生成交叉点的 z 容差。	Double
measure_field	交叉点处基本路径上的测量值。	Field

派生输出

名称	说明	数据类型
out_feature_class	详细说明对 in_feature_class 参数值所做更改的输出要素类。	Feature Class

代码示例

CreateLRSIntersectionFromExistingDataset 示例 1（Python 窗口）

以下脚本演示了如何在 Python 窗口中使用 CreateLRSIntersectionFromExistingDataset 函数。

# Name: Create_LRS_Intersection_From_Existing_Dataset_ex1.py
# Description: Create an LRS Intersection from an existing dataset.
# Requires: ArcGIS Location Referencing

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Tool variables
parent_network = r"C:\Demo.gdb\LRS\Network"
network_description_field = "RouteName"
in_feature_class = r"C:\Demo.gdb\LRS\Intersection1"
intersection_id_field = "IntersectionId"
intersection_name_field = "IntersectionName"
route_id_field = "RouteID"
feature_id_field = "featureId"
feature_class_name_field = "featureClassName"
from_date_field = "FromDate"
to_date_field = "ToDate"
intersecting_layers = "[{Network, RouteID, RouteName, & RouteName:}]"
measure_field = "Measure"

# Set current workspace
arcpy.env.workspace = "C:\Demo.gdb"

# Execute the tool
arcpy.locref.CreateLRSIntersectionFromExistingDataset(parent_network, network_description_field, in_feature_class, 
                                                      intersection_id_field, intersection_name_field, route_id_field, 
                                                      feature_id_field, feature_class_name_field, from_date_field, 
                                                      to_date_field, intersecting_layers, measure_field)


# Check in license
arcpy.CheckInExtension('LocationReferencing')

CreateLRSIntersectionFromExistingDataset 示例 2（独立脚本）

以下脚本演示了如何在独立脚本中使用 CreateLRSIntersectionFromExistingDataset 函数。

# Name: Create_LRS_Event_From_Existing_Dataset_ex2.py
# Description: Register an existing feature class as an event in this stand-alone script.
# Requires: ArcGIS Location Referencing 

# Import arcpy module
import arcpy 

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Tool variables
parent_network = r"C:\Demo.gdb\LRS\Network"
network_description_field = "RouteName"
in_feature_class = r"C:\Demo.gdb\LRS\Intersection1"
intersection_id_field = "IntersectionId"
intersection_name_field = "IntersectionName"
route_id_field = "RouteID"
feature_id_field = "featureId"
feature_class_name_field = "featureClassName"
from_date_field = "FromDate"
to_date_field = "ToDate"
intersecting_layers = "[{Network, RouteId, RouteName, & RouteName:}]"
measure_field = "Measure"

# Set current workspace
arcpy.env.workspace = "C:\Demo.gdb"

# Execute the tool
arcpy.locref.CreateLRSIntersectionFromExistingDataset(parent_network, network_description_field, in_feature_class, 
                                                      intersection_id_field, intersection_name_field, route_id_field, 
                                                      feature_id_field, feature_class_name_field, from_date_field, 
                                                      to_date_field, intersecting_layers, measure_field)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

环境

此工具不使用任何地理处理环境。

许可信息

• Basic: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
• Standard: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）
• Advanced: 需要 ArcGIS Location Referencing（ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways）