导入宗地结构点 (宗地)

摘要

将源点要素类中的点数据导入到宗地结构要素类中。匹配或处于源点的邻近容差范围内的宗地结构点将使用导入的点数据进行更新。如果源点图层具有选定内容,则仅会导入选定的点信息。

宗地结构点可通过以下方式进行更新:

  • 可以将点停用,且可使用所导入点中的更新信息来创建新点。
  • 可以使用源点中的属性信息来更新点。现有的宗地结构点仍将保持活动状态(非历史)。

如果源和目标宗地结构点满足搜索条件,并且源点要素类具有 z 值,则将更新宗地结构点的形状 x,y,z 坐标。如果源点要素类没有 z 值,则仅更新宗地结构点的形状 x,y 坐标,并且现有 z 值保持不变。在更新宗地结构点的形状 x,y 坐标后,连接的宗地线和面将更新以匹配新的坐标位置。

在创建点后,可选择将其分配给新的或现有宗地记录

使用情况

  • 此工具将修改目标宗地结构中的数据。宗地结构点属性值可能会发生更改。宗地结构点、线和面几何可能发生更改。该工具不会删除宗地结构要素。

  • 搜索距离通过比较源点的形状 x,y 坐标与宗地结构点的形状 x,y 坐标进行应用。搜索距离将忽略 z 值。

  • 该工具可以更新宗地结构点的属性和几何(形状坐标),或仅更新几何。在更新属性后,系统将使用源点属性值来更新与源点要素类中的字段相匹配的宗地结构点字段。

  • 如果源点要素类和目标宗地结构的空间参考不匹配,则工具会将源点要素类投影到目标宗地结构所使用的坐标系。如果源点要素类与目标宗地结构的空间参考地理基准面不匹配,则必须在源点要素类上执行地理变换,以匹配目标宗地结构的地理基准面,然后才能运行此工具。

  • 如果在源点的邻近容差范围内存在多个宗地结构点,则系统会将冲突报告为警告消息。可选择在冲突表中报告冲突。如果为冲突表参数指定了冲突表,则源点和宗地结构点的对象 ID 将存储在该表中。

  • 系统会将所导入的点分配给记录名称参数中指定的记录。如果记录尚不存在,则将创建具有指定名称的记录。

    系统将导入新点以停用现有的宗地结构点,新点将被导入到空宗地结构或不存在点的区域中。导入新点以停用现有的点时,请使用更新类型参数的停用并替换选项。现有的点将按照记录名称参数中指定的记录停用。

参数

标注说明数据类型
源点

此源点要素类将用于更新目标宗地结构中的点。

Feature Layer
目标宗地结构

包含要更新的点的目标宗地结构。目标宗地结构可来自文件地理数据库、连接到默认版本的企业级地理数据库或要素服务。

Parcel Layer
匹配点方法

指定将用于查找与源点匹配的宗地结构点的方法。

  • 邻近分析处于源点的邻近容差范围内的宗地结构点将与源点匹配并更新。这是默认设置。
  • 名称与邻近性 处于源点的邻近容差范围内且与源点名称相同的宗地结构点将与源点匹配并更新。
  • 全局 ID 与邻近性处于源点的邻近容差范围内且与源点的全局 ID 相同的宗地结构点将与源点匹配并更新。全局 ID 存储在宗地结构点要素类上的 Global ID 字段中,以及源要素类的指定 Global ID 字段中。
String
搜索距离
(可选)

将用于搜索处于源点附近的宗地结构点的距离。如果宗地结构点处于源点的搜索距离内,则系统将匹配这些点并更新宗地结构点。

Linear Unit
更新类型

指定将应用于与源点匹配的宗地结构点的更新类型。

  • 所有将更新宗地结构点的几何 (x,y,z) 和匹配属性字段。如果更新了宗地结构点的几何,则重合宗地要素也会更新。这是默认设置。
  • 几何 (x,y,z) 仅会更新宗地结构点的几何 (x,y,z)。重合宗地要素也将更新。
  • 停用并替换源点将作为新的宗地结构点进行导入。任何匹配的宗地结构点都将作为历史宗地结构点停用。每个匹配的宗地结构点的 Retired By Record 字段都将使用记录名称参数中指定的记录的 GlobalID 进行填充。
String
记录名称
(可选)

将与新的导入点关联的记录的名称。

如果记录已存在于目标宗地结构中,则新点将与记录相关联。如果记录不存在,则将创建一个记录。如果用新点替换现有点,且将更新类型设置为停用并替换(Python 中的 update_type = RETIRE_AND_REPLACE),则可将记录用于停止将点用作历史记录。

String
匹配字段
(可选)

名称与邻近性(Python 中的 NAME_AND_PROXIMITY)或全局 ID 与邻近性(Python 中的 GLOBALID_AND_PROXIMITY)用于匹配点方法(Python 中的 match_point_method)参数时,用于将源点与宗地结构点相匹配的字段。按名称进行搜索时,源点要素类中的字段应为“文本”类型。按全局 ID 进行搜索时,源点要素类中的字段应为 GUID 类型。

Field
冲突表
(可选)

将存储冲突的输出表的路径和名称。如果源点的搜索容差范围内存在多个宗地结构点,则系统将在冲突表中报告源点和宗地结构点的对象 ID。

Table

派生输出

标注说明数据类型
已更新宗地结构

经过更新的宗地结构。

宗地图层

arcpy.parcel.ImportParcelFabricPoints(source_points, target_parcel_fabric, match_point_method, {search_distance}, update_type, {record_name}, {match_field}, {conflicts_table})
名称说明数据类型
source_points

此源点要素类将用于更新目标宗地结构中的点。

Feature Layer
target_parcel_fabric

包含要更新的点的目标宗地结构。目标宗地结构可来自文件地理数据库、连接到默认版本的企业级地理数据库或要素服务。

Parcel Layer
match_point_method

指定将用于查找与源点匹配的宗地结构点的方法。

  • PROXIMITY处于源点的邻近容差范围内的宗地结构点将与源点匹配并更新。这是默认设置。
  • NAME_AND_PROXIMITY 处于源点的邻近容差范围内且与源点名称相同的宗地结构点将与源点匹配并更新。
  • GLOBALID_AND_PROXIMITY处于源点的邻近容差范围内且与源点的全局 ID 相同的宗地结构点将与源点匹配并更新。全局 ID 存储在宗地结构点要素类上的 Global ID 字段中,以及源要素类的指定 Global ID 字段中。
String
search_distance
(可选)

将用于搜索处于源点附近的宗地结构点的距离。如果宗地结构点处于源点的搜索距离内,则系统将匹配这些点并更新宗地结构点。

Linear Unit
update_type

指定将应用于与源点匹配的宗地结构点的更新类型。

  • ALL将更新宗地结构点的几何 (x,y,z) 和匹配属性字段。如果更新了宗地结构点的几何,则重合宗地要素也会更新。这是默认设置。
  • GEOMETRY_XYZ 仅会更新宗地结构点的几何 (x,y,z)。重合宗地要素也将更新。
  • RETIRE_AND_REPLACE源点将作为新的宗地结构点进行导入。任何匹配的宗地结构点都将作为历史宗地结构点停用。每个匹配的宗地结构点的 Retired By Record 字段都将使用记录名称参数中指定的记录的 GlobalID 进行填充。
String
record_name
(可选)

将与新的导入点关联的记录的名称。

如果记录已存在于目标宗地结构中,则新点将与记录相关联。如果记录不存在,则将创建一个记录。如果用新点替换现有点,且将更新类型设置为停用并替换(Python 中的 update_type = RETIRE_AND_REPLACE),则可将记录用于停止将点用作历史记录。

String
match_field
(可选)

名称与邻近性(Python 中的 NAME_AND_PROXIMITY)或全局 ID 与邻近性(Python 中的 GLOBALID_AND_PROXIMITY)用于匹配点方法(Python 中的 match_point_method)参数时,用于将源点与宗地结构点相匹配的字段。按名称进行搜索时,源点要素类中的字段应为“文本”类型。按全局 ID 进行搜索时,源点要素类中的字段应为 GUID 类型。

Field
conflicts_table
(可选)

将存储冲突的输出表的路径和名称。如果源点的搜索容差范围内存在多个宗地结构点,则系统将在冲突表中报告源点和宗地结构点的对象 ID。

Table

派生输出

名称说明数据类型
updated_parcel_fabric

经过更新的宗地结构。

宗地图层

代码示例

ImportParcelFabricPoints 示例(Python 窗口)

以下 Python 窗口脚本演示了如何在即时模式下使用 ImportParcelFabricPoints 工具将点导入宗地结构。

import arcpy
arcpy.parcel.ImportParcelFabricPoints(
    "C:/Parcels/Database.gdb/UpdatePoints",
    "C:/Parcels/Database.gdb/County/CountyFabric", 'PROXIMITY', '0.1 Feet', 
    'ALL', 'Record001', None, "C:/Parcels/Database.gdb/ConflictsTable")

环境

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

许可信息

  • Basic: 否
  • Standard: 是
  • Advanced: 是

相关主题