描述
将源点要素类中的点数据导入到宗地结构点要素类中。匹配或处于源点的邻近容差范围内的宗地结构点将使用导入的点数据进行更新。如果源点图层具有选定内容，则仅会导入选定的点信息。
宗地结构点可通过以下方式进行更新：
- 可以将点停用，且可使用所导入点中的更新信息来创建新点。
- 可以使用源点中的属性信息来更新点。现有的宗地结构点仍将保持活动状态（非历史）。
如果源和目标宗地结构点满足搜索条件，并且源点要素类具有 z 值，则将更新宗地结构点的形状 x,y,z 坐标。如果源点要素类没有 z 值，则仅更新宗地结构点的形状 x,y 坐标，并且现有 z 值保持不变。在更新宗地结构点的形状 x,y 坐标后，连接的宗地线和面将更新以匹配新的坐标位置。
在创建点后，可选择将其分配给新的或现有宗地记录。
使用方法
此工具将修改目标宗地结构中的数据。宗地结构点属性值可能会发生更改。宗地结构点、线和面几何可能发生更改。该工具不会删除宗地结构要素。
搜索距离通过比较源点的形状 x,y 坐标与宗地结构点的形状 x,y 坐标进行应用。搜索距离将忽略 z 值。
该工具可以更新宗地结构点的属性和几何（形状坐标），或仅更新几何。在更新属性后，系统将使用源点属性值来更新与源点要素类中的字段相匹配的宗地结构点字段。
如果源点要素类和目标宗地结构的空间参考不匹配，则工具会将源点要素类投影到目标宗地结构所使用的坐标系。如果源点要素类与目标宗地结构的空间参考地理基准面不匹配，则必须在源点要素类上执行地理变换，以匹配目标宗地结构的地理基准面，然后才能运行此工具。
如果在源点的邻近容差范围内存在多个宗地结构点，则系统会将冲突报告为警告消息。可选择在冲突表中报告冲突。如果为冲突表参数指定了冲突表，则源点和宗地结构点的对象 ID 将存储在该表中。
系统会将所导入的点分配给记录名称参数中指定的记录。如果记录尚不存在，则将创建具有指定名称的记录。
系统将导入新点以停用现有的宗地结构点，新点将被导入到空宗地结构或不存在点的区域中。导入新点以停用现有的点时，请使用更新类型参数的停用并替换选项。现有的点将按照记录名称参数中指定的记录停用。
语法
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 | 指定将用于查找与源点匹配的宗地结构点的方法。
| String |
search_distance （可选） | 将用于搜索处于源点附近的宗地结构点的距离。如果宗地结构点处于源点的搜索距离内，则系统将匹配这些点并更新宗地结构点。 | Linear Unit |
update_type | 指定将应用于与源点匹配的宗地结构点的更新类型。
| 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 | 经过更新的宗地结构。 | 宗地图层 |
代码示例
以下 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: 是