トップへ戻る

屋内画像のインポート (Import Indoor Images) (Indoors)

このトピックの内容

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

サマリー

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

使用法

  • このツールを使用して、360 度写真とパノラマ画像を、方向付き画像データセットに読み込みます。 フロア対応の方向付き画像レイヤーをフロア対応マップに含めることができます。

  • このツールは、.e57 ファイルに含まれる 360 度およびパノラマ JPEG 画像をサポートします。 画像は正距円筒 (球面) リプレゼンテーションを使用する必要があります。

  • このツールを選択または定義クエリを含む入力レベル フィーチャとともに使用して、特定のフロアのみに画像をインポートします。

  • [ターゲットの方向付き画像レイヤー] パラメーターの値は、Z 対応の方向付き画像レイヤーの必要があります。 [方向付き画像データセットの作成 (Create Oriented Imagery Dataset)] ツールを使用して、方向付き画像を作成します。

    この方向付き画像レイヤーは、ローカルの方向付き画像データセット、またはホスト フィーチャ サービスのものです。 ホスト フィーチャ サービスに写真をインポートするとき、フィーチャ サービスはフィーチャ アタッチメントをサポートしている必要があります。

  • [入力データの座標系] パラメーターを使用して、入力データの水平および鉛直座標系を指定します。

    • 入力 .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 の値が正しいことを確認し、必要に応じて [フィールド演算 (Calculate Field)] ツールを使用して CameraHeading の値を調整します。

    • HorizontalFieldOfView- 水平方向のカメラの範囲 (度)。
      • 有効な値の範囲は 0 ～ 360 です。
      • このツールが割り当てるデフォルト値は 360 です。 [視野の水平角] パラメーターを使用して、この値を調整します。
    • VerticalFieldOfView- 垂直方向のカメラの範囲 (度)。
      • 有効な値の範囲は 0 ～ 180 です。
      • このツールが割り当てるデフォルト値は 180 です。 [視野の鉛直角] パラメーターを使用して、この値を調整します。
    • OrientedImageryType- 方向付き画像のタイプ。 このツールでは、値に 360 が割り当てられます。これは、画像が球状またはパノラマのサラウンド ビューを提供することを示しています。

  • このツールで出力される方向付き画像をフロア対応として構成し、フロア対応マップのフロア フィルターで使用できます。

  • インポートされた画像は、[ターゲットの画像フォルダー] パラメーターに指定されたフォルダーのローカル ファイルとして保存されます。

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

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

  • インポート時に、ターゲットの方向付き画像データセット内の既存のフィーチャは保持されます。

パラメーター

ダイアログPython

ラベル説明データ タイプ
入力データ

インポートされるターゲットの方向付き画像ファイルを含む .e57 ファイル。

File
入力レベル フィーチャ

ターゲット画像レイヤーと同じワークスペースに存在する ArcGIS Indoors 情報モデルの関連付けられたレイヤー。

Feature Layer
ターゲットの画像フォルダー

画像ファイルが書き込まれる既存のフォルダー。

Folder
ターゲットの方向付き画像

フィーチャの追加先となる、ターゲットの方向付き画像レイヤー。

Oriented Imagery Layer
入力データの座標系
(オプション)

入力画像ファイルの空間参照。 入力データ ファイルに座標系が指定されていない場合は、座標系を選択できます。

Spatial Reference
高さの調整
(オプション)

インポートされた画像の Z 値を調整する値。 インポートされた画像が再投影される場合、調整は投影後に適用されます。 デフォルト値は 0 メートルです。

  • 値を -300 フィートに設定すると、インポートされた画像の Z 値が 300 フィート減少します。
  • 値を 250 メートルに設定すると、インポートされた画像の Z 値が 250 メートル増加します。
Double
視野の水平角
(オプション)

インポートされた画像の視野の有効幅 (度)。 有効な値の範囲は 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 メートル増加します。
Double
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
ImportIndoorImages_Indoors(in_level_features, target_image_folder, target_oriented_imagery, in_coordinate_system,
                           elevation_adjustment, horizontal_field_of_view, vertical_field_of_view)

環境

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

ライセンス情報

  • Basic: No
  • Standard: 次のものが必要 ArcGIS Indoors Pro または ArcGIS Indoors Maps
  • Advanced: 次のものが必要 ArcGIS Indoors Pro または ArcGIS Indoors Maps

関連トピック

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

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

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