导入宗地结构点 (宗地)

摘要

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

可以导入点以停用和替换现有宗地结构点的位置,或者更新现有宗地结构点的位置。 可以将点导入到空宗地结构或不存在点的区域中。

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

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

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

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

使用情况

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

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

    注:
    如果现有宗地结构点的 IsFixed 字段设置为是,则这些点将不会通过匹配导入的点进行更新。 要更新这些点,请确保将它们的 IsFixed 字段设置为否。

  • 搜索距离通过比较源点的形状 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
记录名称
(可选)

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

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

String
匹配字段
(可选)

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

Field
冲突表
(可选)

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

Table
更新和创建选项
(可选)

指定是更新点、创建点还是两者皆有。 当指定更新匹配点或创建不匹配点仅更新匹配点选项时,可选参数可用于过滤匹配的目标宗地结构点。

注:

如果现有点的 IsFixed 字段设置为是,则不会更新现有点。

  • 更新匹配点或创建不匹配点如果使用搜索条件未找到匹配点,则将创建点。 如果使用搜索条件找到了匹配点,则将更新这些点。 可以选择使用 SQL 表达式来过滤目标宗地结构中的匹配点。 这是默认设置。
  • 仅创建不匹配点仅当使用搜索条件未找到匹配时,才创建点。 如果使用搜索条件找到了匹配点,这些点将保留并且不会创建任何点。
  • 仅更新匹配点如果使用搜索条件找到了匹配点,则将更新点。 可以选择使用 SQL 表达式来过滤目标宗地结构中的匹配点。 如果未找到匹配点,则将不会更新点。
String
目标宗地结构点
(可选)

将通过 SQL 表达式进行过滤的宗地结构点图层。

Feature Layer
过滤目标宗地结构点
(可选)

一个 SQL 表达式,用于过滤在目标宗地结构点图层中找到的匹配点。 例如,仅更新未作为历史结构点 (RetiredByRecord IS NULL) 停用的匹配点。

SQL Expression

派生输出

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

经过更新的宗地结构。

Parcel Layer

arcpy.parcel.ImportParcelFabricPoints(source_points, target_parcel_fabric, match_point_method, {search_distance}, update_type, {record_name}, {match_field}, {conflicts_table}, {update_create_option}, {target_points}, {where_clause})
名称说明数据类型
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
(可选)

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

如果记录已存在于目标宗地结构中,则新点将与记录相关联。 如果记录不存在,则将创建一个记录。 如果用新点替换现有点,且 update_typeRETIRE_AND_REPLACE,则可将记录用于停止将点用作历史记录。

String
match_field
(可选)

NAME_AND_PROXIMITYGLOBALID_AND_PROXIMITY 用于 match_point_method 参数时,用于将源点与宗地结构点相匹配的字段。 按名称进行搜索时,源点要素类中的字段应为“文本”类型。 按全局 ID 进行搜索时,源点要素类中的字段应为 GUID 类型。

Field
conflicts_table
(可选)

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

Table
update_create_option
(可选)

指定是更新点、创建点还是两者皆有。 当指定 UPDATE_AND_CREATEUPDATE_ONLY 选项时,可选参数可用于过滤匹配的目标宗地结构点。

注:

如果现有点的 IsFixed 字段设置为是,则不会更新现有点。

  • UPDATE_AND_CREATE如果使用搜索条件未找到匹配点,则将创建点。 如果使用搜索条件找到了匹配点,则将更新这些点。 可以选择使用 SQL 表达式来过滤目标宗地结构中的匹配点。 这是默认设置。
  • CREATE_ONLY仅当使用搜索条件未找到匹配时,才创建点。 如果使用搜索条件找到了匹配点,这些点将保留并且不会创建任何点。
  • UPDATE_ONLY如果使用搜索条件找到了匹配点,则将更新点。 可以选择使用 SQL 表达式来过滤目标宗地结构中的匹配点。 如果未找到匹配点,则将不会更新点。
String
target_points
(可选)

将通过 SQL 表达式进行过滤的宗地结构点图层。

Feature Layer
where_clause
(可选)

一个 SQL 表达式,用于过滤在目标宗地结构点图层中找到的匹配点。 例如,仅更新未作为历史结构点 (RetiredByRecord IS NULL) 停用的匹配点。

SQL Expression

派生输出

名称说明数据类型
updated_parcel_fabric

经过更新的宗地结构。

Parcel Layer

代码示例

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", 'UPDATE_AND_CREATE')

环境

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

许可信息

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

相关主题