可用于具有 Indoors 扩展模块许可的 ArcGIS 组织。
创建或更新符合 ArcGIS Indoors 信息模型的员工或占用者点数据。
该工具会根据输入建筑空间（单位）生成点要素，然后使用占用者数据丰富这些点。 此工具的输出可用于支持室内分析和 Indoors web 和移动应用程序中的功能，如搜索、路径分析、工作空间预订和空间规划。
此工具已弃用。 此功能已被更新占用者要素工具替换，工具将更新符合 ArcGIS Indoors 信息模型的 Occupants 要素类，该要素类由ArcGIS Pro 3.0 的创建 Indoors 数据库工具自动生成。
输入单元要素参数值必须是来自 Indoors 地理数据库或室内数据集的要素图层或要素类。
输入单元要素值必须包括 Units 要素类的 Indoors 模型描述的 AREA_ID 字段。
输入占用者表参数值必须为地理数据库表、Microsoft Excel 工作簿中的工作表（.xls 或 .xlsx）或逗号分隔的文本文件 (.csv)。
输入占用者表的值必须包含以下字段：
您也可以在输入占用者表中包括以下字段以增强 Space Planner 应用程序体验：
如果输入的占用者单元标识符字段参数为空（针对 .csv 文件或 Excel 工作表）或 <Null>（针对地理数据库表），则占用者将以未分配状态加载。
默认情况下，输入单元要素参数的坐标系将用于输出占用者要素类参数。 可通过“输出坐标系”环境设置覆盖此设置。
输出占用者要素类将包含以下基于输入单位要素参数值填充的字段：
LEVEL_ID 和 UNIT_ID 字段将使用输入单元要素参数中的相应值填充。 UNIT_NAME 字段将填充相应输入单元要素的 NAME 值。
输出占用者要素类的值包括 Indoor Space Planner 应用程序使用的以下字段：
SITE_ID 字段将基于以下内容进行填充：
在为 Indoor Viewer、Space Planner、ArcGIS Indoors for iOS 或 ArcGIS Indoors for Android 客户端应用程序准备地图时，可在地图的 People 图层中使用该工具的输出。
该工具会更新 Space Planner 所使用的输入单元要素属性。 如果为某个单元生成了占用者点要素，则该单元的属性将会更新，如下所示：
| 标注 | 说明 | 数据类型 |
输入单元要素 |
输入面要素，表示可能被占用的建筑空间。 在 ArcGIS Indoors 信息模型中，此项将为 Units 图层。 每个空间的质心将用作一个或多个占用者的点位置。 | Feature Layer |
单元标识符字段 | 输入单元要素参数值中的字段，将用作主键以将建筑空间与输入占用者表参数值中的记录相关联。 | Field |
输入占用者表 | 包含有关建筑占用者信息的输入表。 信息可以存储在地理数据库表、Excel 工作簿中的工作表（.xls 或 .xlsx 文件）或 .csv 文件中。 | Table View |
占用者单元标识符字段 | 输入占用者表参数值中的字段，将用作主键以将占用者与输入单元要素参数值相关联。 | Field |
输出占用者要素类 | 通过连接输入单元要素和输入占用者表参数值创建的输出要素类。 | Feature Class |
| 标注 | 说明 | 数据类型 |
| 已更新的单位要素类 | 已更新的输入单元要素图层。 | Feature Class |
arcpy.indoors.GenerateOccupantFeatures(in_unit_features, unit_id_field, in_occupant_table, occupant_id_field, out_occupant_feature_class)
| 名称 | 说明 | 数据类型 |
in_unit_features |
输入面要素，表示可能被占用的建筑空间。 在 ArcGIS Indoors 信息模型中，此项将为 Units 图层。 每个空间的质心将用作一个或多个占用者的点位置。 | Feature Layer |
unit_id_field | in_unit_features 参数值中的字段，将用作主键以将建筑空间与 in_occupant_table 参数值中的记录相关联。 | Field |
in_occupant_table | 包含有关建筑占用者信息的输入表。 信息可以存储在地理数据库表、Excel 工作簿中的工作表（.xls 或 .xlsx 文件）或 .csv 文件中。 | Table View |
occupant_id_field | in_occupant_table 参数值中的字段，将用作主键以将占用者与 in_unit_features 参数值相关联。 | Field |
out_occupant_feature_class | 通过连接 in_unit_features 和 in_occupant_table 参数值创建的输出要素类。 | Feature Class |
| 名称 | 说明 | 数据类型 |
| updated_unit_feature_class | 已更新的输入单元要素图层。 | Feature Class |
以下 Python 窗口脚本演示了如何在即时模式下使用 GenerateOccupantFeatures 函数。 在此示例中，输入和输出位于同一地理数据库中。
import arcpy
arcpy.indoors.GenerateOccupantFeatures('C:/Indoors/ExampleCampus.gdb/Indoor/Units',
'UNIT_ID',
'C:/Indoors/ExampleCampus.gdb/EMPLOYEEINFO',
'LOCATION',
'C:/Indoors/ExampleCampus.gdb/Indoor/Occupants')以下独立脚本演示了如何使用 GenerateOccupantFeatures 函数。
# Name: Indoors_GenerateOccupantFeatures_example2.py
# Description: Imports occupant information from an Excel spreadsheet to a
# point feature class in an indoor dataset or Indoors geodatabase.
import arcpy
# Use the Units feature class in the indoor dataset or Indoors geodatabase as the input unit features
in_unit_features = 'C:/Indoors/ExampleCampus.gdb/Indoor/Units'
# The join will use the NAME field from Units feature class
unit_id_field = 'NAME'
# Use an Excel spreadsheet as the input occupant table
in_occupant_table = r'C:\Indoors\EmployeeInfo.xls\MarketingDept$'
# The spreadsheet's OFFICE column has values that match those in Units' NAME field
occupant_id_field = 'OFFICE'
# Output Occupants feature class
out_occupant_feature_class = 'C:/Indoors/ExampleCampus.gdb/Indoor/Occupants'
# Execute GenerateOccupantFeatures
arcpy.indoors.GenerateOccupantFeatures(in_unit_features, unit_id_field,
in_occupant_table, occupant_id_field,
out_occupant_feature_class)