概要
ジオタグ付き写真に保存された X、Y、および Z 座標からポイントを作成します。また、写真ファイルを出力フィーチャクラスのフィーチャにジオデータベース アタッチメントとして追加することもできます。
図
使用法
このツールは、写真ファイルから経度、緯度、および高度の座標を読み取り、これらの座標と関連属性を出力ポイント フィーチャクラスに書き出します。
出力フィーチャクラスには、次の属性フィールドがあります。
- 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 (オプション) | すべての写真ファイルを出力フィーチャクラスに含めるか、有効な座標を持つファイルのみを含めるかを指定します。
| Boolean |
Add_Photos_As_Attachments (オプション) | 入力写真を出力フィーチャにジオデータベース アタッチメントとして追加するかどうかを指定します。 ライセンス:アタッチメントを追加するには、ArcGIS Desktop Standard 以上のライセンスが必要です。また、出力フィーチャクラスは、バージョン 10 以上のジオデータベースに含まれている必要があります。
| Boolean |
コードのサンプル
次の Python ウィンドウ スクリプトは、GeoTaggedPhotosToPoints ツールの使用方法を示しています。
import arcpy
arcpy.GeoTaggedPhotosToPoints_management("c:/data/photos",
"c:/data/city.gdb/photo_points", "",
"ONLY_GEOTAGGED", "ADD_ATTACHMENTS")
次のスクリプトで、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: はい