Indoor Positioning データセットの生成 (Indoor Positioning ツール)

サマリー

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

このツールでは、ArcGIS IPS Information Model の IPS Positioning データセット、IPS Positioning ポイントフィーチャクラス、IPS Positioning 信号テーブルが更新されます。

使用法

このツールでは、次のいずれかの方法を使用して IPS Positioning データセットが生成されます。
- サーベイベース— IPS レコーディングフィーチャは、ArcGIS IPS Setup アプリを使用してサーベイ時に収集された信号で構成されています。この方法では、IPS レコーディングフィーチャとレベルフィーチャのみを指定する必要がありますが、IPS ビーコンフィーチャも指定すると、適応型無線測位が有効になり、Android デバイスでの測位の精度が向上します。 IPS ビーコンフィーチャを指定した場合、IPS ビーコンフィーチャクラスのビーコンから発信されたのではなく IPS サーベイレコーディング時にキャプチャーされた無線信号はフィルターによって除外されます。
- サーベイなし— この方法では、IPS ビーコンフィーチャ、IPS エリアフィーチャ、壁フィーチャ、およびレベルフィーチャを指定する必要があります。これらのフィーチャは、屋内環境を通して Bluetooth 信号の伝達をシミュレートするために使用されます。
出力データセット名 パラメーターの値は、ターゲット IPS 測位データセット パラメーターで設定したフィーチャクラスの Dataset Name フィールド内で一意である必要があります。
レベルフィーチャ パラメーターの値は、ArcGIS Indoors Information Model の Levels フィーチャクラスに準拠するフィーチャクラスまたはフィーチャレイヤーである必要があります。
- サーベイベース 生成方法を使用する場合、LEVEL_ID フィールドの少なくとも 1 つの有効な IPS レコーディングフィーチャにレベルを関連付ける必要があります。
- サーベイなし 生成方法を使用する場合、少なくとも 4 つのビーコンフィーチャ、1 つの IPS エリアフィーチャ、1 つの壁フィーチャにレベルを関連付ける必要があります。
- さらに、次の属性が有効、最新であり、かつ NULL であってはなりません。
  - LEVEL_ID
  - VERTICAL_ORDER
  - FACILITY_ID
IPS レコーディングフィーチャ パラメーター値は、ArcGIS IPS モデルの IPS_Recordings フィーチャクラスに準拠するフィーチャレイヤーまたはフィーチャクラスである必要があります。一般的な配置ワークフローでは、パラメーター値は ArcGIS Online または ArcGIS Enterprise で共有されたマップの一部になります。

注意:

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

施設に両方のラジオタイプのサーベイレコーディングが含まれている場合、ツールを実行する前にいずれかのラジオタイプのフィーチャを選択します。たとえば、属性検索 ツールを使用して、両方のタイプを含む施設の Bluetooth 記録をすべて選択してから、選択したフィーチャに対してのみツールを実行します。 SITE_ID フィールドには、ジオプロセシングジョブごとに 1 つのサイト ID のみを含めることができます。追加のサイトを別個の IPS 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 にできません。
- フィーチャジオメトリーは、関連付けられたレベル内に含まれている必要があります。
既存データセットの更新 パラメーターの値は、ブール値の必要があります。 IPS Positioning データセットを更新するには、既存データセットの更新 パラメーターをオンにします。
- サーベイベースの IPS Positioning データセットの更新の詳細
- サーベイなしの IPS Positioning データセットの詳細
ヒント:

後からデータセットを更新したい場合、マップ上で IPS Positioning データセット (および IPS Positioning ポイントフィーチャクラスと IPS Positioning 信号テーブル) を共有します。

注意:

既存データセットの更新 パラメーターをオンにすると、ジオメトリー補助 IPS Positioning データセットから通過可能性情報が削除されます。通過可能性情報を復元するには、正確かつ最新の IPS レイヤーで Indoor Positioning データセットへのジオメトリーの追加 ツールを再実行します。
既存のデータセット パラメーター値は、既存データセットの更新 パラメーターがオンのときのみ使用できます。このパラメーターの値は、ターゲット IPS 測位データセット パラメーター値に含まれている既存の IPS Positioning データセットの名前である必要があります。このデータセットに含まれているデータは、ツールの入力と組み合わせて、既存データセットの更新バージョンを生成するため使用されます。

ラベル	説明	データタイプ
ターゲット IPS 測位データセット	生成された IPS Positioning データセットが格納されるフィーチャクラス。	Feature Layer
出力データセット名	出力 IPS Positioning データセットの名前。出力データセット名は、ターゲットの IPS 測位フィーチャクラスの `Dataset Name` フィールド内で一意の必要があります。	String
生成方法	IPS Positioning データセットの生成に使用する方法を指定します。サーベイベース—データセットは IPS レコーディングを処理して生成されます。サーベイなし—データセットは、屋内環境を通して Bluetooth 信号の伝達をシミュレートして生成されます。	String
レベルフィーチャ	施設内のレベルのフットプリントを表すポリゴンフィーチャ。	Feature Layer
IPS レコーディングフィーチャ (オプション)	IPS Setup レコーディングを含むフィーチャクラスまたはフィーチャサービス。サーベイベースの測位データセットの更新時には、IPS Setup サーベイレコーディングと品質レコーディングを使用できますが、品質レコーディングは既存データセットの更新パラメーターがオンになっている場合にのみ使用できます。このパラメーターは、生成方法パラメーターがサーベイベースに設定されている場合に必須です。	Feature Layer
IPS ビーコンフィーチャ (オプション)	屋内環境に配置される Bluetooth ビーコンの位置と設定を表すポイントフィーチャクラス。生成方法パラメーターをサーベイベースに設定して Bluetooth IPS Positioning データセットを生成する際に、有効なビーコンフィーチャを指定すると、適応型無線測位が有効になり、Android デバイスでの屋内測位の精度が向上します。このパラメーターは、生成方法パラメーターがサーベイなしに設定されている場合に必須です。	Feature Layer
IPS エリアフィーチャ (オプション)	IPS Positioning データセットが生成されるエリアを表すポリゴンフィーチャ。このパラメーターは、生成方法パラメーターがサーベイなしに設定されている場合に必須です。	Feature Layer
壁フィーチャ (オプション)	壁の物理的範囲を表すポリゴンフィーチャ。このパラメーターは、生成方法パラメーターがサーベイなしに設定されている場合に必須です。	Feature Layer
既存データセットの更新 (オプション)	既存データセットとツールの入力を組み合わせて IPS Positioning データセットを作成するかどうかを指定します。このパラメーターは、生成方法パラメーターがサーベイベースに設定されている場合のみ有効です。オン—既存データセットとツールの入力を組み合わせて IPS Positioning データセットが作成されます。オフ—新しい IPS Positioning データセットが作成されます。これがデフォルトです。	Boolean
既存データセット (オプション)	ターゲット IPS 測位データセットパラメーターで設定したフィーチャクラスに含まれている既存のデータセットの名前。このパラメーターの値は、ターゲットフィーチャクラスに含まれている既存の IPS Positioning データセットの名前である必要があります。このデータセットに含まれているデータは、ツールの入力と組み合わせて、既存データセットの更新バージョンを生成するため使用されます。このパラメーターは、既存データセットの更新パラメーターと組み合わせてのみ使用されます。	String

派生した出力

ラベル	説明	データタイプ
更新された IPS 測位データセット	新しく作成された IPS 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	生成された IPS Positioning データセットが格納されるフィーチャクラス。	Feature Layer
dataset_name	出力 IPS Positioning データセットの名前。出力データセット名は、ターゲットの IPS 測位フィーチャクラスの `Dataset Name` フィールド内で一意の必要があります。	String
generation_method	IPS Positioning データセットの生成に使用する方法を指定します。 `SURVEY_BASED`—データセットは IPS レコーディングを処理して生成されます。 `SURVEY_LESS`—データセットは、屋内環境を通して Bluetooth 信号の伝達をシミュレートして生成されます。	String
in_levels	施設内のレベルのフットプリントを表すポリゴンフィーチャ。	Feature Layer
in_ips_recordings (オプション)	IPS Setup レコーディングを含むフィーチャクラスまたはフィーチャサービス。サーベイベースの測位データセットの更新時には、IPS Setup サーベイレコーディングと品質レコーディングを使用できますが、品質レコーディングは `update_existing` パラメーターが `UPDATE_EXISTING` に設定されている場合にのみ使用できます。このパラメーターは、`generation_method` パラメーターが `SURVEY_BASED` に設定されている場合に必須です。	Feature Layer
in_beacons (オプション)	屋内環境に配置される Bluetooth ビーコンの位置と設定を表すポイントフィーチャクラス。 `generation_method` パラメーターを `SURVEY_BASED` に設定して Bluetooth IPS Positioning データセットを生成する際に、有効なビーコンフィーチャを指定すると、適応型無線測位が有効になり、Android デバイスでの屋内測位の精度が向上します。このパラメーターは、`generation_method` パラメーターが `SURVEY_LESS` に設定されている場合に必須です。	Feature Layer
in_ips_areas (オプション)	IPS Positioning データセットが生成されるエリアを表すポリゴンフィーチャ。このパラメーターは、`generation_method` パラメーターが `SURVEY_LESS` に設定されている場合に必須です。	Feature Layer
in_walls (オプション)	壁の物理的範囲を表すポリゴンフィーチャ。このパラメーターは、`generation_method` パラメーターが `SURVEY_LESS` に設定されている場合に必須です。	Feature Layer
update_existing (オプション)	既存データセットとツールの入力を組み合わせて IPS Positioning データセットを作成するかどうかを指定します。このパラメーターは、`generation_method` パラメーターが `SURVEY_BASED` に設定されている場合にのみ有効です。 `UPDATE_EXISTING`—既存データセットとツールの入力を組み合わせて IPS Positioning データセットが作成されます。 `NO_UPDATE_EXISTING`—新しい IPS Positioning データセットが作成されます。これがデフォルトです。	Boolean
existing_dataset (オプション)	`target_ips_positioning_datasets` パラメーターで設定したフィーチャクラスに含まれている既存のデータセットの名前。このパラメーターの値は、ターゲットフィーチャクラスに含まれている既存の IPS Positioning データセットの名前である必要があります。このデータセットに含まれているデータは、ツールの入力と組み合わせて、既存データセットの更新バージョンを生成するため使用されます。このパラメーターは、`update_existing` パラメーターと組み合わせてのみ使用されます。	String

派生した出力

名前	説明	データタイプ
out_ips_datasets	新しく作成された IPS Positioning データセットが含まれている、更新された IPS 測位データセットフィーチャクラス。	Feature Layer

コードのサンプル

GenerateIndoorPositioningDataset の例 1 (Python スタンドアロンスクリプト)

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

# Name: GenerateIndoorPositioningDataset_example1.py
# Description: Generates an IPS positioning dataset
# using the survey-based method.

# Import system modules
import arcpy.indoorpositioning as ips

# 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

ips.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 関数のサーベイなしの方法を使用して IPS Positioning データセットを生成する方法を示しています。

# Name: GenerateIndoorPositioningDataset_example2.py
# Description: Generates an IPS positioning dataset
# using the survey-less method.

# Import system modules
import arcpy.indoorpositioning as ips

# 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
ips.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 スタンドアロンスクリプトは、既存データセットとツールの入力のデータを組み合わせて、サーベイベースの方法で既存の IPS Positioning データセットを更新する方法を示しています。

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

# Import system modules

import arcpy.indoorpositioning as ips

# 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
ips.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: いいえ
Standard: ArcGIS IPS が必要
Advanced: ArcGIS IPS が必要

Indoor Positioning データ セットの生成 (Indoor Positioning ツール)

サマリー

使用法

注意:

注意:

ヒント:

注意:

パラメーター

派生した出力

環境

ライセンス情報

関連トピック

Indoor Positioning データセットの生成 (Indoor Positioning ツール)