入室者フィーチャの生成 (Generate Occupant Features) (Indoors)

Indoors の機能のライセンスが付与されたポータルで利用できます。​

概要

ArcGIS Indoors Information Model に準拠する従業員または入室者のポイント データを作成または更新します。

このツールは、入力建物スペース (ユニット) に基づいてポイント フィーチャを生成し、それらのポイントに入室者データを付加します。このツールの出力は、Indoors のマッピングとルート検索のサポートに使用できます。

使用法

  • [入力ユニット フィーチャ] パラメーターは、Units フィーチャクラスの Indoors Model に準拠するフィーチャ レイヤーまたはフィーチャクラスである必要があります。

  • [入力ユニット フィーチャ] には、ユニット フィーチャクラスの Indoors Model によって示された AREA_ID フィールドが含まれている必要があります。

  • [入力入室者テーブル] パラメーターは、ジオデータベース テーブル、Excel ワークブック (*.xls または *.xlsx ファイル) のシート、またはカンマ区切りテキスト ファイル (*.csv) である必要があります。

  • [入力入室者テーブル] には、次のフィールドが含まれている必要があります。

    • KNOWNAS - 入室者を検索するときによく使用される姓と名
    • EMAIL - 入室者の電子メール アドレス
    • CONTACT_PHONE - 入室者の電話番号
    • CONTACT_EXTENSION - 入室者に関連付けられているエクステンション コード (該当する場合)

    入室者データの読み込みに関する詳細

  • デフォルトでは、[入力ユニット フィーチャ] の座標系は、[出力入室者フィーチャクラス] パラメーターに使用されます。これは、出力座標系ジオプロセシング環境設定で上書きできます。

  • ツールの出力には、Indoor Space Planner アプリで使用される次のフィールドが含まれます。

    • AREA_ID
    • ORG_LEVEL_1
    • ORG_LEVEL_2
    • JOB_TITLE
    • START_DATE

    注意:

    入力テーブルに AREA_ID フィールドを追加しないでください。このフィールドは Indoor Space Planner アプリによって管理されます。他のフィールドで入力テーブルを更新し、値を入力します。

  • Indoor ViewerArcGIS Indoors for iOS、または ArcGIS Indoors for Android クライアント アプリ用のマップを準備するとき、このツールの出力をマップの [People] レイヤーで使用できます。

  • ツールによって、Space Planner が使用する [入力ユニット フィーチャ] 属性が更新されます。ユニットに入室者ポイント フィーチャが生成されると、そのユニットの属性は次のように更新されます。

    • ASSIGNMENT_TYPE[Office] に設定されます。
    • AREA_ID[NULL] に設定されます。

構文

arcpy.indoors.GenerateOccupantFeatures(in_unit_features, unit_id_field, in_occupant_table, occupant_id_field, out_occupant_feature_class)
パラメーター説明データ タイプ
in_unit_features

入室する建物スペースを表す入力ポリゴン フィーチャ。ArcGIS Indoors Information Model では、これは Units レイヤーになります。各スペースの重心は、入室者のポイント位置として使用されます。

Feature Layer
unit_id_field

建物空間を [入力入室者テーブル] のレコードと関連付けるプライマリ キーとして使用される、[入力ユニット フィーチャ] 内のフィールド。

Field
in_occupant_table

建物の入室者に関する情報を含む入力テーブル。

情報は、ジオデータベース テーブル、Excel ワークブック (*.xls または *.xlsx ファイル) のシート、または *.csv ファイルに格納できます。

Table View
occupant_id_field

入室者を [入力ユニット フィーチャ] と関連付けるプライマリ キーとして使用される [入力入室者テーブル] 内のフィールド。

Field
out_occupant_feature_class

[入力ユニット フィーチャ][入力入室者テーブル] パラメーターの値を結合して作成される出力フィーチャクラス。

Feature Class

派生した出力

名前説明データ タイプ
updated_unit_feature_class

更新された入力ユニット フィーチャ レイヤー。

フィーチャクラス

コードのサンプル

GenerateOccupantFeatures (入室者フィーチャの生成) の例 1 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、イミディエイト モードで GenerateOccupantFeatures 関数を使用する方法を示しています。この例では、入力および出力はすべて同じジオデータベース内にあります。

import arcpy
arcpy.indoors.GenerateOccupantFeatures('C:/Indoors/ExampleCampus.gdb/Indoors/Units', 
                                       'UNIT_ID', 
                                       'C:/Indoors/ExampleCampus.gdb/EMPLOYEEINFO', 
                                       'LOCATION', 
                                       'C:/Indoors/ExampleCampus.gdb/Indoors/People')
GenerateOccupantFeatures (入室者フィーチャの生成) の例 2 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトで、GenerateOccupantFeatures 関数を使用する方法を示します。

# Name: Indoors_GenerateOccupantFeatures_example2.py
# Description: Imports occupant information from an Excel spreadsheet to a 
#              points feature class in an Indoors geodatabase.

import arcpy

# Use the Indoors geodatabase's Units feature class as the input unit features
in_unit_features = 'C:/Indoors/ExampleCampus.gdb/Indoors/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 People Points feature class
out_occupant_feature_class = 'C:/Indoors/ExampleCampus.gdb/Indoors/People'

# Execute GenerateOccupantFeatures
arcpy.indoors.GenerateOccupantFeatures(in_unit_features, unit_id_field, 
                                       in_occupant_table, occupant_id_field, 
                                       out_occupant_feature_class)

ライセンス情報

  • Basic: いいえ
  • Standard: いいえ
  • Advanced: 次のものが必要 Indoors

関連トピック