向室内定位数据集添加几何 (室内定位)

可用于具有 ArcGIS IPS 扩展模块许可的 ArcGIS 组织。

摘要

生成启用几何辅助室内定位所需的可遍历性信息。

生成的信息作为附件存储到指定的输入室内定位系统 (IPS) 定位数据集中。 工具根据输入数据生成折线要素图层，可用于直观检查每个有效级别的连接的可遍历路径。

插图

连通性图（第二幅图像）是根据输入要素类（第一幅图像）生成的。 线（边）代表可能的室内运动。 粉色线代表室内和室外区域之间的过渡边，蓝色线代表室内边。

使用情况

• 工具在常规点格网上创建一个图表，涵盖有效级别的要素，其中边代表可能的室内运动。 当移动不受障碍物要素参数指定的图层中的障碍物要素（例如墙壁或障碍）阻碍时，会在相邻格网节点之间添加边。 图表仅在由指定的 IPS 定位数据集要素类和 IPS 区域要素的交集定义的区域内创建。 可以扩展图表以使用为入口/出口要素参数指定的图层中的要素连接到室外空间。

• 目标 IPS 定位数据集参数必须为符合 ArcGIS IPS 信息模型中 IPS 定位数据集要素类的面要素类，并且必须启用附件。 可以使用创建 IPS 数据模型工具进行创建。

• 目标 IPS 定位数据集名称参数值可以从为目标 IPS 定位数据集参数指定的 IPS 定位数据集中的可用数据集名称中选择。

• 楼层要素参数值必须是面图层，用于表示设施点中包含的每个楼层的覆盖区。 所选图层必须满足以下条件：

  • 图层必须包含 LEVEL_ID、VERTICAL_ORDER 和 FACILITY_ID 字段。
  • 图层必须与用于生成为目标 IPS 定位数据集参数选择的 IPS 定位数据集的图层相同。

• IPS 区域要素参数值必须是面图层，表示将启用几何辅助室内定位的室内区域。 所选图层中的 IPS 区域要素仅当满足以下条件时才有效：

  • 图层必须包含 LEVEL_ID 字段。
  • 图层必须与楼层要素参数所选图层中的某一要素共享 LEVEL_ID 字段值。
  • LEVEL_ID 字段值不得为空。
  • IPS 区域要素的几何必须包含在相关楼层中。

  提示：

  您可以通过多种方式为 IPS 区域要素创建图层。 一种推荐的方法是从 ArcGIS Indoors 信息模型中的单元要素类中选择标注为走廊和门厅的要素。 还可以手动创建 IPS 区域要素，从而可以根据组织的需要灵活地定制数据。

• 障碍物要素参数值必须是表示阻碍用户移动的物理障碍的折线图层。 所选图层必须满足以下条件：

  • 图层必须包含 LEVEL_ID 字段。
  • LEVEL_ID 字段值不得为空。
  • 如果图层符合 Indoors 模型中的细节图层，请确保所选的障碍物要素仅代表不可通行的物体或障碍物。
  • 如果 IPS 定位点覆盖可遍历的物体或障碍物（例如门或楼梯），请确保这些要素不包含在所选的障碍物要素中。

    注：

    如果在为障碍物要素参数提供的图层中未选择任何要素，则工具会将图层中的所有要素都处理为障碍物要素。

  

  IPS 区域（绿色）内代表可遍历物体的要素，例如门或楼梯，不应包含在所选障碍物要素中。 例如，在第一幅图像中，连通性图表在门要素（红色）附近断开，因为它们被选为障碍物要素。 在第二幅图像中，连通性图表沿着廊道平滑延伸，因为门被排除在所选障碍物要素之外。 第二张图像是正确的，因为它允许蓝点更容易地穿过 IPS 区域内的可行走空间。

• 出口/入口要素参数值必须是表示连接室内和室外空间的入口和出口过渡区域的图层。 所选图层必须满足以下条件：

  • 图层必须包含 FACILITY_ID、VERTICAL_ORDER_FROM 和 VERTICAL_ORDER_TO 字段。
  • 工具仅处理包含两个折点的线要素。
  • 工具仅处理生成至少一个连接到室内-室内边的室内-室外边的​​线要素。

  注：

  您可以使用 Indoors 模型中的 Transitions 图层作为此参数的输入。 如果您正在使用 Transitions 图层，则必须在运行工具之前配置入口和出口要素。 仅处理已配置的入口和出口要素。

  

  如果提供入口和出口要素，工具会生成室内到室外过渡边（粉色），以启用从室内空间到室外空间的平滑过渡。

参数

对话框

标注	说明	数据类型
目标 IPS 定位数据集	包含 IPS 定位数据集的输入要素类或图层。	Feature Layer
目标 IPS 定位数据集名称	目标 IPS 定位数据集将通过几何数据进行丰富，以支持几何辅助室内定位。	String
楼层要素	包含表示建筑物楼层的面要素的要素类或图层。	Feature Layer
IPS 区域要素	包含表示将启用几何辅助室内定位的区域的面要素的要素类或图层。	Feature Layer
障碍要素	包含表示不可穿越的物理障碍（例如墙壁、家具、窗户和柱子）的折线要素的要素类或图层。 障碍图层必须包含 LEVEL_ID 字段。 在 Indoors 模型中，这可以是 Details 要素图层的子集。	Feature Layer
入口/出口要素 (可选)	要素类或图层，包含表示室内空间和室外空间之间的入口通道的折线要素。 入口通道要素图层必须包含 FACILITY_ID、VERTICAL_ORDER_FROM 和 VERTICAL_ORDER_TO 字段。 在 Indoors 模型中，这可以是针对 IPS 配置的 Transitions 图层。	Feature Layer

派生输出

标注	说明	数据类型
更新 IPS 定位数据集	包含更新的附件的更新后的 IPS 定位数据集要素类。	Feature Layer
IPS 派生步行要素	表示从输入数据中派生的步行路径的折线要素。 该输出表示根据输入数据确定的可遍历的路径。	Feature Layer

Python

arcpy.indoorpositioning.AddGeometryToIndoorPositioningDataset(target_ips_positioning_datasets, target_ips_positioning_dataset_name, in_level_features, in_ips_area_features, in_obstacle_features, {in_entrance_exit_features})

名称	说明	数据类型
target_ips_positioning_datasets	包含 IPS 定位数据集的输入要素类或图层。	Feature Layer
target_ips_positioning_dataset_name	目标 IPS 定位数据集将通过几何数据进行丰富，以支持几何辅助室内定位。	String
in_level_features	包含表示建筑物楼层的面要素的要素类或图层。	Feature Layer
in_ips_area_features	包含表示将启用几何辅助室内定位的区域的面要素的要素类或图层。	Feature Layer
in_obstacle_features	包含表示不可穿越的物理障碍（例如墙壁、家具、窗户和柱子）的折线要素的要素类或图层。 障碍图层必须包含 LEVEL_ID 字段。 在 Indoors 模型中，这可以是 Details 要素图层的子集。	Feature Layer
in_entrance_exit_features (可选)	要素类或图层，包含表示室内空间和室外空间之间的入口通道的折线要素。 入口通道要素图层必须包含 FACILITY_ID、VERTICAL_ORDER_FROM 和 VERTICAL_ORDER_TO 字段。 在 Indoors 模型中，这可以是针对 IPS 配置的 Transitions 图层。	Feature Layer

派生输出

名称	说明	数据类型
out_ips_positioning_datasets	包含更新的附件的更新后的 IPS 定位数据集要素类。	Feature Layer
out_ips_derived_walkable_features	表示从输入数据中派生的步行路径的折线要素。 该输出表示根据输入数据确定的可遍历的路径。	Feature Layer

代码示例

AddGeometryToIndoorPositioningDataset 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 AddGeometryToIndoorPositioningDataset 函数。

import arcpy
arcpy.indoorpositioning.AddGeometryToIndoorPositioningDataset(r"C:\Data\IPS\IndoorPositioningDatasets",
                                                "PositioningDataset3",
                                                r"C:\Data\BuildingData\Floor1"
                                                r"C:\Data\IPS\IpsAreaFeatures"
                                                r"C:\Data\BuildingData\Obstacles"
                                                r"C:\Data\BuildingData\Entrance-Exits")

AddGeometryToIndoorPositioningDataset 示例 2（独立脚本）

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

# Name: AddGeometryToIndoorPositioningDataset_example2.py
# Description: Adds geometry information to the IPS positioning dataset as an attachment.

# Import system modules
import arcpy.indoorpositioning as ips

# Set local variables
target_ips_positioning_datasets = r"C:\Users\myUser\Documents\ArcGIS\Projects\DemoProject\DemoProject.gdb\IPS_Positioning_Datasets" 
target_ips_positioning_dataset_name = "ExistingDataset" 
in_level_features = r"C:\Users\myUser\Documents\ArcGIS\Projects\DemoProject\DemoProject.gdb\Levels" 
in_ips_area_features = r"C:\Users\myUser\Documents\ArcGIS\Projects\DemoProject\DemoProject.gdb\IPS_Area" 
in_obstacle_features = r"C:\Users\myUser\Documents\ArcGIS\Projects\DemoProject\DemoProject.gdb\Obstacles" 
in_entrance_exit_features = r"C:\Users\myUser\Documents\ArcGIS\Projects\DemoProject\DemoProject.gdb\Entrace_Exit" 

# Call the AddGeometryToIndoorPositioningDataset tool
arcpy.indoorpositioning.AddGeometryToIndoorPositioningDataset(target_ips_positioning_datasets,
                                          target_ips_positioning_dataset_name,
                                          in_level_features,
                                          in_ips_area_features,
                                          in_obstacle_features,
                                          in_entrance_exit_features)

环境

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

许可信息

• Basic: 否
• Standard: 需要 ArcGIS IPS
• Advanced: 需要 ArcGIS IPS