屋内画像のインポート (Indoors ツール)

サマリー

360 度写真とパノラマ画像を、.e57 ファイルから方向付き画像データセットにインポートします。このツールの出力は、ArcGIS Pro のフロア対応マップおよびシーンに追加できます。

使用法

このツールを使用して、方向付き画像データセットに 360 度写真とパノラマ画像を読み込みます。フロア対応の方向付き画像レイヤーをフロア対応マップに含めることができます。
このツールは、.e57 ファイルに含まれる 360 度およびパノラマ JPEG 画像をサポートします。画像は正距円筒 (球面) リプレゼンテーションを使用する必要があります。
このツールを選択または定義クエリーを含む入力レベルフィーチャとともに使用して、特定のフロアのみに画像をインポートします。
ターゲットの方向付き画像レイヤー パラメーターの値は、Z 対応の方向付き画像レイヤーの必要があります。 方向付き画像データセットの作成 ツールを使用して、方向付き画像を作成します。

この方向付き画像レイヤーは、ローカルの方向付き画像データセット、またはホストフィーチャサービスのものです。ホストフィーチャサービスに写真をインポートするとき、フィーチャサービスはフィーチャ添付ファイルをサポートしている必要があります。
入力データの座標系 パラメーターを使用して、入力データの水平および鉛直座標系を指定します。
- 入力 .e57 ファイルに座標系が指定または定義されていない場合、入力データは入力レベルフィーチャと同じ座標系に存在すると見なされます。
- 入力データと入力レベルフィーチャの座標系が異なる場合、ツールはインポートされた画像の位置を再変換します。
このツールは、フロア認識に対応するため、ターゲットの方向付き画像データセットに LEVEL_ID フィールドが存在しなければ追加します。
このツールは、画像とレベルフィーチャの Z 値の比較に基づいて、次のように画像にレベル ID を割り当てます。
- 画像には、その画像の垂直方向またはすぐ下に配置されているレベルフィーチャのレベル ID が割り当てられます。
- 画像の Z 値が最低レベル未満、または最高レベルより 15 メートル以上高い場合、その画像のレベル ID 値には NULL が割り当てられます。
- すべてのレベルフィーチャから外れている画像 (X、Y 座標に基づく) のレベル ID 値には NULL が割り当てられます。
入力データと入力レベルレイヤーフィーチャの Z 原点が異なる場合、高さの調整 パラメーターを使用してその差を補正します。高さの調整は、画像の位置に必要な再投影が行われた後に適用されます。

たとえば、入力データに海水面を基準とする Z 値が含まれ、入力レベルフィーチャに地面を基準とする Z 値が含まれている場合、負の 高さの調整 パラメーター値を使用してその差を補正します。次の図に例を示します。

レベルフィーチャに対して画像を垂直に配置するため、-400 m の負の高さデータの調整が適用されています。
このツールは、次のように方向付き画像フィーチャ属性を設定します:
- Shape—X、Y、Z 座標の値は、入力データファイルの画像の位置情報に基づいています。
- Name—入力データファイルのメタデータに含まれる画像の名前。メタデータが使用できない場合、入力データファイル名に増加する数値が付加されたものが使用されます。
  
  注意:
  
  この値は、ImagePath フィールドの画像ファイル名とは異なる場合があります。
- LEVEL_ID—関連付けられたレベルフィーチャのレベル ID。関連付けられたレベルが判定できない場合、NULL 値が割り当てられます。
- ImagePath—フィーチャに関連付けられた画像ファイルのパス。
- AcquisitionDate—入力ファイルのメタデータに含まれる取得日。メタデータが使用できない場合、入力データファイルの最終更新日時が使用されます。
- CameraHeading—入力データファイルの画像の回転情報に基づくカメラの方向。値の単位は度です。
  - カメラが向いている方向の値は、北が 0 度として定義された正の時計回りの方向で計測されます。
  - このツールでは、方向付き画像の CameraPitch または CameraRoll 属性は設定されません。
    
    注意:
    
    カメラの方向情報は、使用するソフトウェアによって異なる方法で格納される場合があります。ツールの出力を確認して CameraHeading の値が正しいことを確認し、必要に応じて フィールド演算 ツールを使用して CameraHeading の値を調整します。
- HorizontalFieldOfView—水平方向のカメラの範囲 (度)。
  - 有効な値の範囲は 0 ～ 360 です。
  - このツールが割り当てるデフォルト値は 360 です。 視野の水平角 パラメーターを使用して、この値を調整します。
- VerticalFieldOfView—垂直方向のカメラの範囲 (度)。
  - 有効な値の範囲は 0 ～ 180 です。
  - このツールが割り当てるデフォルト値は 180 です。 視野の鉛直角 パラメーターを使用して、この値を調整します。
- OrientedImageryType—方向付き画像のタイプ。このツールでは、値に 360 が割り当てられます。これは、画像が球状またはパノラマのサラウンドビューを提供することを示しています。
このツールで出力される方向付き画像をフロア対応として構成し、フロア対応マップのフロアフィルターで使用できます。
インポートされた画像は、ターゲットの画像フォルダー パラメーターに指定されたフォルダーのローカルファイルとして保存されます。

ターゲットの方向付き画像 パラメーターの値がローカルの方向付き画像データセットなら、方向付き画像データセットからサービスを生成 ツールを使用して、ホストフィーチャサービスをインポートされた画像付きで公開します。

ターゲットの方向付き画像 パラメーターの値がホストフィーチャサービスなら、インポートされた画像は方向付き画像レイヤーのフィーチャに添付ファイルとして追加されます。
インポート時に、ターゲットの方向付き画像データセット内の既存のフィーチャは保持されます。

ラベル	説明	データタイプ
入力データ	インポートされるターゲットの方向付き画像ファイルを含む `.e57` ファイル。	File
入力レベルフィーチャ	ターゲット画像レイヤーと同じワークスペースに存在する ArcGIS Indoors 情報モデルの関連付けられたレイヤー。	Feature Layer
ターゲットの画像フォルダー	画像ファイルが書き込まれる既存のフォルダー。	Folder
ターゲットの方向付き画像	フィーチャの追加先となる、ターゲットの方向付き画像レイヤー。	Oriented Imagery Layer
入力データの座標系 (オプション)	入力画像ファイルの空間参照。入力データファイルに座標系が指定されていない場合は、座標系を選択できます。	Spatial Reference
高さの調整 (オプション)	インポートされた画像の Z 値を調整する値。インポートされた画像が再投影される場合、調整は投影後に適用されます。デフォルト値は 0 メートルです。値を -300 フィートに設定すると、インポートされた画像の Z 値が 300 フィート減少します。値を 250 メートルに設定すると、インポートされた画像の Z 値が 250 メートル増加します。	Linear Unit
視野の水平角 (オプション)	インポートされた画像の視野の有効幅 (度)。有効な値の範囲は 0 ～ 360 です。デフォルト値は 360 です。	Double
視野の鉛直角 (オプション)	インポートされた画像の視野の有効な高さ (度)。有効な値の範囲は 0 ～ 180 です。デフォルト値は 180 です。	Double

派生した出力

ラベル	説明	データタイプ
更新されたターゲット方向付き画像	Indoors ワークスペース内の更新された方向付き画像データセット。既存の方向付き画像データはインポート時に保持されます。入力データの各画像に新しいポイントフィーチャが追加され、関連付けられた画像がアタッチメントファイルとして追加されます。新たに追加されたポイントフィーチャの属性は、入力画像ファイルの属性に基づいて設定されます。	Oriented imagery Layer

arcpy.indoors.ImportIndoorImages(in_data, in_level_features, target_image_folder, target_oriented_imagery, {in_coordinate_system}, {elevation_adjustment}, {horizontal_field_of_view}, {vertical_field_of_view})

名前	説明	データタイプ
in_data	インポートされるターゲットの方向付き画像ファイルを含む `.e57` ファイル。	File
in_level_features	ターゲット画像レイヤーと同じワークスペースに存在する ArcGIS Indoors 情報モデルの関連付けられたレイヤー。	Feature Layer
target_image_folder	画像ファイルが書き込まれる既存のフォルダー。	Folder
target_oriented_imagery	フィーチャの追加先となる、ターゲットの方向付き画像レイヤー。	Oriented Imagery Layer
in_coordinate_system (オプション)	入力画像ファイルの空間参照。入力データファイルに座標系が指定されていない場合は、座標系を選択できます。	Spatial Reference
elevation_adjustment (オプション)	インポートされた画像の Z 値を調整する値。インポートされた画像が再投影される場合、調整は投影後に適用されます。デフォルト値は 0 メートルです。値を -300 フィートに設定すると、インポートされた画像の Z 値が 300 フィート減少します。値を 250 メートルに設定すると、インポートされた画像の Z 値が 250 メートル増加します。	Linear Unit
horizontal_field_of_view (オプション)	インポートされた画像の視野の有効幅 (度)。有効な値の範囲は 0 ～ 360 です。デフォルト値は 360 です。	Double
vertical_field_of_view (オプション)	インポートされた画像の視野の有効な高さ (度)。有効な値の範囲は 0 ～ 180 です。デフォルト値は 180 です。	Double

派生した出力

名前	説明	データタイプ
updated_target_oriented_imagery	Indoors ワークスペース内の更新された方向付き画像データセット。既存の方向付き画像データはインポート時に保持されます。入力データの各画像に新しいポイントフィーチャが追加され、関連付けられた画像がアタッチメントファイルとして追加されます。新たに追加されたポイントフィーチャの属性は、入力画像ファイルの属性に基づいて設定されます。	Oriented imagery Layer

コードのサンプル

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

次の Python ウィンドウスクリプトは、イミディエイトモードで ImportIndoorImages 関数を使用する方法を示しています。

arcpy.indoors.ImportIndoorImages(r"C:\BuildingScans\BuildingA.e57",
                                 r"C:\IndoorsModel.gdb\Indoors\Levels",
                                 r"C:\indoorsphotos\photos",
                                 r"C:\IndoorsModel.gdb\OIDataset",
                                 '', '', '')

ImportIndoorImages の例 2 (Python ウィンドウ)

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

# Import system modules
import arcpy

#Set parameter values
in_data=r"C:\BuildingScans\BuildingA.e57"
in_level_features=r"C:\IndoorsModel.gdb\Indoors\Levels"
target_image_folder=r"C:\indoorsphotos\photos"
target_oriented_imagery=r"C:\IndoorsModel.gdb\Indoors\OIDataset"
in_coordinate_system='PROJCS["NAD_1983_2011_StatePlane_California_VI_FIPS_0406",GEOGCS["GCS_NAD_1983_2011",' \
                           'DATUM["D_NAD_1983_2011",SPHEROID["GRS_1980",6378137.0,298.257222101]],' \
                           'PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],' \
                           'PROJECTION["Lambert_Conformal_Conic"],PARAMETER["False_Easting",2000000.0],' \
                           'PARAMETER["False_Northing",500000.0],PARAMETER["Central_Meridian",-116.25],' \
                           'PARAMETER["Standard_Parallel_1",32.78333333333333],' \
                           'PARAMETER["Standard_Parallel_2",33.88333333333333],' \
                           'PARAMETER["Latitude_Of_Origin",32.16666666666666],' \
                           'UNIT["Meter",1.0],AUTHORITY["EPSG",6425]]'
elevation_adjustment="-396 Meters"
horizontal_field_of_view=360
vertical_field_of_view=180

#Run the tool
arcpy.indoors.ImportIndoorImages(in_level_features, target_image_folder, target_oriented_imagery, in_coordinate_system,
                           elevation_adjustment, horizontal_field_of_view, vertical_field_of_view)

環境

このツールは、ジオプロセシング環境を一切使用しません。

ライセンス情報

Basic: いいえ
Standard: ArcGIS Indoors Pro または ArcGIS Indoors Maps が必要
Advanced: ArcGIS Indoors Pro または ArcGIS Indoors Maps が必要

屋内画像のインポート (Indoors ツール)

サマリー

使用法

注意:

注意:

パラメーター

派生した出力

環境

ライセンス情報

関連トピック