トップへ戻る

Indoor Positioning データセットの生成 (Generate Indoor Positioning Dataset) (Indoor Positioning)

このトピックの内容

  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報

サマリー

既存の ArcGIS IPS インストールの Indoor Positioning データセットを生成します。 サーベイベースまたはサーベイなしの方法を使用して、データセットを生成できます。

このツールは、ArcGIS IPS Information Model の IPS 測位データセット フィーチャクラス、IPS 測位信号テーブル、および IPS 測位ポイント フィーチャクラスを更新します。

使用法

  • このツールは、次のいずれかの生成方法を使用して、Indoor Positioning データセットを生成します:

    • [サーベイベース] - IPS レコーディング フィーチャは、ArcGIS IPS Setup アプリを使用してサーベイ時に収集された信号で構成されています。 この方法では、IPS レコーディング フィーチャとレベル フィーチャを指定する必要があります。
    • [サーベイなし] - これらのフィーチャは、屋内環境を通して Bluetooth 信号の伝達をシミュレートするために使用されます。 この方法では、IPS ビーコン フィーチャ、IPS エリア フィーチャ、壁フィーチャ、およびレベル フィーチャを指定する必要があります。

  • [出力データセット名] パラメーターの値は、ターゲットの IPS 測位フィーチャクラスの Dataset Name フィールド内で一意の必要があります。

  • [レベル フィーチャ] パラメーター値は、ArcGIS Indoors Information Model のレベル フィーチャクラスに準拠するフィーチャクラスまたはフィーチャ レイヤーである必要があります。

    • [サーベイベース] 生成方法を使用する場合、LEVEL_ID フィールドの少なくとも 1 つの有効な IPS レコーディング フィーチャにレベルを関連付ける必要があります。
    • [サーベイなし] 生成方法を使用する場合、少なくとも 4 つのビーコン フィーチャ、1 つの IPS エリア フィーチャ、1 つの壁フィーチャにレベルを関連付ける必要があります。
    • さらに、次の属性が有効、最新であり、かつ NULL であってはなりません。
      • LEVEL_ID
      • VERTICAL_ORDER
      • FACILITY_ID

  • [IPS レコーディング フィーチャ] パラメーター値は、IPS データ モデルの IPS_Recordings フィーチャクラスに準拠するフィーチャ レイヤーまたはフィーチャクラスである必要があります。 一般的な配置ワークフローでは、パラメーター値は ArcGIS Online または Enterprise に共有されたマップの一部です。

    注意:

    Bluetooth と WiFi の配置を混在させることは可能ですが、サイト内の異なる施設に限ります。 Bluetooth による測位が可能な施設と、WiFi による測位が可能な施設がありますが、同じ施設に対して Bluetooth の記録と WiFi の記録を 1 つの Indoor Positioning データセットで処理することはできません。

    施設に両方のラジオ タイプのサーベイ レコーディングが含まれている場合、ツールを実行する前にいずれかのラジオ タイプのフィーチャを選択します。 たとえば、[属性検索 (Select Layer By Attribute)] ツールを使用して、両方のタイプを含む施設の Bluetooth 記録をすべて選択してから、選択したフィーチャに対してのみツールを実行します。 SITE_ID フィールドには、ジオプロセシング ジョブごとに 1 つのサイト ID のみを含めることができます。 追加のサイトを個別の Indoor Positioning データセットとして処理します。

  • [IPS ビーコン フィーチャ] パラメーター値は、IPS データ モデルの IPS ビーコン フィーチャクラスに準拠するフィーチャ レイヤーまたはフィーチャクラスの必要があります。 フィーチャ ジオメトリは正確でなくてはならず、次の属性は有効、最新であり、かつ NULL であってはなりません。

    • UUID
    • MAJOR
    • MINOR
    • LEVEL_ID
    • RSSI_1M
    注意:

    詳細については、ブログ記事「How to maintain beacon data for ArcGIS IPS」をご参照ください。

  • [IPS エリア フィーチャ] パラメーター値は、屋内測位を有効にする屋内エリアを正確に表すポリゴン フィーチャクラスまたはフィーチャ レイヤーである必要があります。 次の条件を満たしている必要があります。

    • IPS エリア フィーチャ スキーマには、LEVEL_ID フィールドが含まれています。
    • IPS エリア フィーチャは、LEVEL_ID 属性を使用して既存のレベルに関連付けられています。
    • LEVEL_ID 属性は NULL にできません。
    • フィーチャ ジオメトリは、関連付けられたレベル内に含まれている必要があります。

    [IPS エリア フィーチャ] パラメーター値は、さまざまな方法で取得できます。 ArcGIS Indoors Information Model のユニット フィーチャクラスからコリドーおよび廊下としてラベル付けされたフィーチャを選択する方法をお勧めします。 あるいは、IPS エリア フィーチャを手動で作成できます。この場合、ニーズやお好みに応じてデータセットを柔軟にカスタマイズできます。 どの取得方法を選択するかは、要件と使用例の複雑さによって決まります。

  • [壁フィーチャ] パラメーターの値は、屋内測位が配置される施設内の壁の物理的範囲をできる限り正確に表すフィーチャ レイヤーまたはフィーチャクラスである必要があります。 これらのフィーチャは既存の Indoors Information Model から抽出できます。 [壁フィーチャ] パラメーター値のスキーマには、フロア対応であるために必要なすべての属性が含まれている必要があります。 次の条件を満たしている必要があります。

    • 壁は、LEVEL_ID 属性を使用して既存のレベルに関連付ける必要があります。
    • LEVEL_ID 属性は NULL にできません。
    • フィーチャ ジオメトリは、関連付けられたレベル内に含まれている必要があります。

  • [既存データセットの更新] パラメーターの値は、ブール値の必要があります。 Indoor Positioning データセットを更新するには、[既存データセットの更新] パラメーターをオンにします。

    • サーベイベースの Indoor Positioning データセットの更新の詳細
    • サーベイなしの Indoor Positioning データセットの更新の詳細
    注意:

    データセットを将来更新する予定なら、マップで Indoor Positioning データセット (Datasets、Points、Signals) を共有します。

  • [既存のデータセット] パラメーター値は、[既存データセットの更新] パラメーターがオンのときのみ使用できます。 このパラメーター値は、[ターゲット IPS 測位データセット] パラメーター値に含まれている既存の Indoor Positioning データセット名の必要があります。 このデータセットに含まれているデータは、ツールの入力と組み合わせて、既存データセットの更新バージョンを生成するため使用されます。

パラメーター

ダイアログPython

ラベル説明データ タイプ
ターゲット IPS 測位データセット

生成された Indoor Positioning データセットが格納されるフィーチャクラス。

Feature Layer
出力データセット名

出力 Indoor Positioning データセットの名前。

出力データセット名は、ターゲットの IPS 測位フィーチャクラスの Dataset Name フィールド内で一意の必要があります。

String
生成方法

Indoor Positioning データセットの生成に使用する方法を指定します。

  • サーベイベース—データセットは IPS レコーディングを処理して生成されます。
  • サーベイなし—データセットは、屋内環境を通して Bluetooth 信号の伝達をシミュレートして生成されます。
String
レベル フィーチャ

施設内のレベルのフットプリントを表すポリゴン フィーチャ。

Feature Layer
IPS レコーディング フィーチャ
(オプション)

IPS Setup サーベイ レコーディングを含むフィーチャクラスまたはフィーチャ サービス。

このパラメーターは、[生成方法] パラメーターが [サーベイベース] に設定されている場合に必須です。

Feature Layer
IPS ビーコン フィーチャ
(オプション)

屋内環境に配置される Bluetooth ビーコンの位置と設定を表すポイント フィーチャクラス。

このパラメーターは、[生成方法] パラメーターが [サーベイなし] に設定されている場合に必須です。

Feature Layer
IPS エリア フィーチャ
(オプション)

Indoor Positioning データセットが生成されるエリアを表すポリゴン フィーチャ。

このパラメーターは、[生成方法] パラメーターが [サーベイなし] に設定されている場合に必須です。

Feature Layer
壁フィーチャ
(オプション)

壁の物理的範囲を表すポリゴンフィーチャ。

このパラメーターは、[生成方法] パラメーターが [サーベイなし] に設定されている場合に必須です。

Feature Layer
既存データセットの更新
(オプション)

Indoor Positioning データセットが、既存データセットとツールの入力を組み合わせて作成されるかどうかを指定します。 このパラメーターは、[生成方法] パラメーターが [サーベイベース] に設定されている場合のみ有効です。

  • オン - 既存データセットとツールの入力を使用して Indoor Positioning データセットが作成されます。
  • オフ - 新しい Indoor Positioning データセットが作成されます。 これがデフォルトです。

Boolean
既存データセット
(オプション)

ターゲットの IPS 測位データセットに含まれている既存データセットの名前。 このパラメーター値は、ターゲット IPS 測位データセットに含まれている既存の Indoor Positioning データセット名の必要があります。 このデータセットに含まれているデータは、ツールの入力と組み合わせて、既存データセットの更新バージョンを生成するため使用されます。 このパラメーターは、[既存データセットの更新] パラメーターと組み合わせてのみ使用されます。

String

派生した出力

ラベル説明データ タイプ
更新された IPS 測位データセット

新しく作成された Indoor Positioning データセットを含む、更新された IPS 測位データセット フィーチャクラス。

Feature Layer

arcpy.indoorpositioning.GenerateIndoorPositioningDataset(target_ips_positioning_datasets, dataset_name, generation_method, in_levels, {in_ips_recordings}, {in_beacons}, {in_ips_areas}, {in_walls}, {update_existing}, {existing_dataset})
名前説明データ タイプ
target_ips_positioning_datasets

生成された Indoor Positioning データセットが格納されるフィーチャクラス。

Feature Layer
dataset_name

出力 Indoor Positioning データセットの名前。

出力データセット名は、ターゲットの IPS 測位フィーチャクラスの Dataset Name フィールド内で一意の必要があります。

String
generation_method

Indoor Positioning データセットの生成に使用する方法を指定します。

  • SURVEY_BASED—データセットは IPS レコーディングを処理して生成されます。
  • SURVEY_LESS—データセットは、屋内環境を通して Bluetooth 信号の伝達をシミュレートして生成されます。
String
in_levels

施設内のレベルのフットプリントを表すポリゴン フィーチャ。

Feature Layer
in_ips_recordings
(オプション)

IPS Setup サーベイ レコーディングを含むフィーチャクラスまたはフィーチャ サービス。

このパラメーターは、generation_method パラメーターが SURVEY_BASED に設定されている場合に必須です。

Feature Layer
in_beacons
(オプション)

屋内環境に配置される Bluetooth ビーコンの位置と設定を表すポイント フィーチャクラス。

このパラメーターは、generation_method パラメーターが SURVEY_LESS に設定されている場合に必須です。

Feature Layer
in_ips_areas
(オプション)

Indoor Positioning データセットが生成されるエリアを表すポリゴン フィーチャ。

このパラメーターは、generation_method パラメーターが SURVEY_LESS に設定されている場合に必須です。

Feature Layer
in_walls
(オプション)

壁の物理的範囲を表すポリゴンフィーチャ。

このパラメーターは、generation_method パラメーターが SURVEY_LESS に設定されている場合に必須です。

Feature Layer
update_existing
(オプション)

Indoor Positioning データセットが、既存データセットとツールの入力を組み合わせて作成されるかどうかを指定します。 このパラメーターは、generation_method パラメーターが SURVEY_BASED に設定されている場合のみ有効です。

  • UPDATE_EXISTING—既存データセットとツールの入力を使用して Indoor Positioning データセットが作成されます。
  • NO_UPDATE_EXISTING—新しい Indoor Positioning データセットが作成されます。 これがデフォルトです。
Boolean
existing_dataset
(オプション)

ターゲットの IPS 測位データセットに含まれている既存データセットの名前。 このパラメーター値は、ターゲット IPS 測位データセットに含まれている既存の Indoor Positioning データセット名の必要があります。 このデータセットに含まれているデータは、ツールの入力と組み合わせて、既存データセットの更新バージョンを生成するため使用されます。 このパラメーターは、update_existing パラメーターと組み合わせてのみ使用されます。

String

派生した出力

名前説明データ タイプ
out_ips_datasets

新しく作成された Indoor Positioning データセットを含む、更新された IPS 測位データセット フィーチャクラス。

Feature Layer

コードのサンプル

GenerateIndoorPositioningDataset の例 1 (Python ウィンドウ)

次の Python ウィンドウのスクリプトは、GenerateIndoorPositioningDataset 関数のサーベイベースの方法を使用して、Indoor Positioning データセットを生成する方法を示しています。

# Name: GenerateIndoorPositioningDataset_example1.py 
# Description: Generates an indoor positioning dataset using the survey-based method. 
 
# Import system modules 
import arcpy 
 
# Set local variables 
ips_datasets = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\IPS_Positioning_Datasets" 
dataset_name = 'NewDataset' 
levels = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\Levels" 
ips_recordings = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\IPS_Recordings" 
 
# Call the GenerateIndoorPositioningDataset tool 
arcpy.indoorpositioning.GenerateIndoorPositioningDataset(target_ips_positioning_datasets=ips_datasets,\ 
                                           dataset_name=dataset_name,\ 
                                           generation_method='SURVEY_BASED',\ 
                                           in_levels=levels,\ 
                                           in_ips_recordings=ips_recordings,\ 
                                           )
GenerateIndoorPositioningDataset の例 2 (Python ウィンドウ)

次の Python ウィンドウのスクリプトは、GenerateIndoorPositioningDataset 関数のサーベイなしの方法を使用して、Indoor Positioning データセットを生成する方法を示しています。

# Name: GenerateIndoorPositioningDataset_example1.py 
# Description: Generates an indoor positioning dataset using the survey-less method. 
 
# Import system modules 
import arcpy 
 
# Set local variables 
ips_datasets = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\IPS_Positioning_Datasets" 
dataset_name = 'NewDataset' 
levels = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\Levels" 
beacons = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\IPS_Beacons" 
ips_areas = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\IPS_Areas" 
walls = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\Walls" 
 
# Call the GenerateIndoorPositioningDataset tool 
arcpy.indoorpositioning.GenerateIndoorPositioningDataset(target_ips_positioning_datasets=ips_datasets,\ 
                                           dataset_name=dataset_name,\ 
                                           generation_method='SURVEY_LESS',\ 
                                           in_levels=levels,\ 
                                           in_beacons=beacons,\ 
                                           in_ips_areas=ips_areas,\ 
                                           in_walls=walls)
GenerateIndoorPositioningDataset の例 3 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、既存データセットとツールの入力のデータを組み合わせ、サーベイベースの方法で既存の Indoor Positioning データセットを更新する方法を示しています。

# Name: GenerateIndoorPositioningDataset_example3.py 
# Description: Updates an existing indoor positioning dataset using the survey-based method by combining data from an existing dataset and the tool inputs.

# Import system modules 

import arcpy 

# Set local variables 
ips_datasets = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\IPS_Positioning_Datasets" 
existing_dataset = 'Dataset1' 
dataset_name = 'Dataset1_updated'
levels = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\Levels" 
ips_recordings = r"C:\\Users\\myUser\\Documents\\ArcGIS\\Projects\\DemoProject\\DemoProject.gdb\IPS_Recordings" 

# Call the GenerateIndoorPositioningDataset tool 
arcpy.indoorpositioning.GenerateIndoorPositioningDataset(target_ips_positioning_datasets=ips_datasets,\
                                           dataset_name=dataset_name,\
                                           generation_method='SURVEY_BASED',\
                                           in_levels=levels,\
                                           in_ips_recordings=ips_recordings,\
                                           update_existing="UPDATE_EXISTING",\
                                           existing_dataset=existing_dataset)

環境

現在のワークスペース

ライセンス情報

  • Basic: No
  • Standard: 次のものが必要 ArcGIS IPS
  • Advanced: 次のものが必要 ArcGIS IPS

関連トピック

  • Indoor Positioning ツールボックスの概要
  • ジオプロセシング ツールの検索

このトピックへのフィードバック

このトピックの内容
  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報