ジオタグ付き写真 → ポイント (GeoTagged Photos To Points) (データ管理)

概要

ジオタグ付き写真に保存された X、Y、および Z 座標からポイントを作成します。また、写真ファイルを出力フィーチャクラスのフィーチャにジオデータベース アタッチメントとして追加することもできます。

[ジオタグ付き写真 → ポイント (GeoTagged Photos To Points)] の図

使用法

  • このツールは、写真ファイルから経度、緯度、および高度の座標を読み取り、これらの座標と関連属性を出力ポイント フィーチャクラスに書き出します。

  • 出力フィーチャクラスには、次の属性フィールドがあります。

    • Path - ポイントの生成に使用する写真ファイルの絶対パス (たとえば、C:\data\photos\Pic0001.jpg)。
    • Name - 写真ファイルの短い名前 (たとえば、Pic0001.jpg)。
    • DateTime - 写真ファイルの元の撮影日時。出力フィーチャクラスがシェープファイルの場合、このフィールドは文字列タイプになります。出力フィーチャクラスがジオデータベースに存在する場合、このフィールドは日付タイプになります。

      DateTime フィールドに NULL または空の値が含まれる場合、デバイスが写真から使用可能なタイムスタンプを取得していない可能性があります。写真ファイルには作成日または変更日のプロパティがありますが、これらが写真の撮影日時を表していない場合もあります。

    • Direction - 写真が撮影されたときにデバイスが向いている方向。値は 0 から 359.99 までの間で、0 は北、90 は東などを表します。デバイスで方向が記録されていない場合、このフィールドの値は、デバイスおよび指定した出力場所に応じて、NULL、0、または -999999 になります。方向値は、真北または磁北からの角度を参照する場合があります。詳細は、デバイスのドキュメントをご参照ください。
      メモ:

      デバイスが記録する方向は正確でない場合があるため、ジオタグが付けられた写真の方向に関する情報は注意して使用します。方向の正確性の詳細についてはデバイスのドキュメントをご参照ください。

    • X - 写真が撮影された X 座標。
    • Y - 写真が撮影された Y 座標。
    • Z - 写真が撮影された高度 (メートル)。デバイスで高度が記録されていなかった場合、このフィールドの値は、デバイスおよび指定した出力場所に応じて、NULL、0、または -999999 になります。

  • 出力 DateTime を使用し、時間を通じて出力フィーチャクラスを解析およびマッピングできます。

  • ツールの出力には、日時ビンの DateTime フィールドに含まれるタイム スタンプ数を使用して写真のタイムラインを示すライン チャートが含まれています。これらのビンは自動的に計算されますが、カスタマイズすることもできます。

  • 写真の X、Y 座標が 0,0 である場合、その写真ではポイントが生成されません。空の座標は、通常、デバイスが受信する信号が不十分で座標を取得できないために発生します。[ジオタグが付加されていない写真を含める] パラメーターをオン (Python では ALL_PHOTOS) にすると、写真は NULL ジオメトリを含む出力フィーチャとして追加されます。

  • GPS 受信機で GCS_WGS_1984 XY および鉛直座標系を使用しているため、出力フィーチャクラスでも同じ座標系が使用されます。

構文

arcpy.management.GeoTaggedPhotosToPoints(Input_Folder, Output_Feature_Class, {Invalid_Photos_Table}, {Include_Non-GeoTagged_Photos}, {Add_Photos_As_Attachments})
パラメーター説明データ タイプ
Input_Folder

写真ファイルが保存されているフォルダー。このフォルダーの写真は再帰的にスキャンされ、このフォルダーにある写真と、そのサブフォルダーにある写真のすべてが出力に追加されます。

Folder
Output_Feature_Class

出力ポイント フィーチャクラス。

Feature Class
Invalid_Photos_Table
(オプション)

入力フォルダーにある写真ファイルを、無効な Exif メタデータ、空の座標、または無効な座標とともに一覧で示すオプションの出力テーブル。

パスが指定されていない場合、このテーブルは作成されません。

Table
Include_Non-GeoTagged_Photos
(オプション)

すべての写真ファイルを出力フィーチャクラスに含めるか、有効な座標を持つファイルのみを含めるかを指定します。

  • ALL_PHOTOS すべての写真を出力フィーチャクラスにレコードとして追加します。写真ファイルに座標情報がない場合は、NULL ジオメトリを含むフィーチャとして追加されます。これがデフォルトです。
  • ONLY_GEOTAGGED 有効な座標情報を含む写真のみを、出力フィーチャクラスに含めます。
Boolean
Add_Photos_As_Attachments
(オプション)

入力写真を出力フィーチャにジオデータベース アタッチメントとして追加するかどうかを指定します。

ライセンス:

アタッチメントを追加するには、ArcGIS Desktop Standard 以上のライセンスが必要です。また、出力フィーチャクラスは、バージョン 10 以上のジオデータベースに含まれている必要があります。

  • ADD_ATTACHMENTS 写真を、ジオデータベースに内部的にコピーされたジオデータベース アタッチメントとして出力フィーチャに追加します。これがデフォルトです。
  • NO_ATTACHMENTS写真を、出力フィーチャにジオデータベース アタッチメントとして追加しません。
Boolean

コードのサンプル

GeoTaggedPhotosToPoints (ジオタグ付き写真 → ポイント) の例 1 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、GeoTaggedPhotosToPoints ツールの使用方法を示しています。

import arcpy
arcpy.GeoTaggedPhotosToPoints_management("c:/data/photos", 
                                         "c:/data/city.gdb/photo_points", "", 
                                         "ONLY_GEOTAGGED", "ADD_ATTACHMENTS")
GeoTaggedPhotosToPoints (ジオタグ付き写真 → ポイント) の例 2 (スタンドアロン スクリプト)

次のスクリプトで、GeoTaggedPhotosToPoints ツールを使用する方法を示します。

"""Name: GeoTaggedPhotosToPoints example
Description: Convert a folder of photos to points, then perform a buffer
""" 
# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data"
 
# Set local variables
inFolder = "photos"
outFeatures = "city.gdb/photos_points"
badPhotosList = "city.gdb/photos_noGPS"
photoOption = "ONLY_GEOTAGGED"
attachmentsOption = "ADD_ATTACHMENTS"
buffers = "city.gdb/photos_points_buffer"
bufferDist = "1 Miles"
arcpy.GeoTaggedPhotosToPoints_management(inFolder, outFeatures, badPhotosList, 
                                         photoOption, attachmentsOption)
arcpy.Buffer_analaysis(outFeatures, buffers, bufferDist)

ライセンス情報

  • Basic: 制限付き
  • Standard: はい
  • Advanced: はい

関連トピック