Tag That Photo ユーザーガイド - パート5¶

メタデータ管理と技術的詳細¶

メタデータ管理の理解¶

メタデータとは何か?¶

メタデータとは「データについてのデータ」であり、画像ファイルに埋め込まれた、またはそれに並んで記載された情報です: - 写真の写っている人物(フェイスタグ) - 撮影された日時 - 撮影場所(GPS座標、場所名) - 内容(キーワード、説明) - 技術的な詳細(カメラ設定、寸法)

TTPのメタデータ哲学¶

Tag That Photoは、**自分のメタデータを所有すべきだ**という原則に基づいています。タグや組織作業は以下の通りです:

1. ポータブルであること - 独自データベースにロックされない
2. 業界標準を使用 - 他のアプリケーションでも読み取れる
3. 画像を持ち歩く - ファイル自体に埋め込まれて
4. ソフトウェア変更に耐える - 特定のベンダーに依存しない

そのため、TTPはAdobe XMPフォーマットやその他の業界標準を使って、画像に直接メタデータを書き込みます。

ExifTool:TTPのメタデータエンジン¶

Tag That Photoは、画像メタデータの読み書きに主要なエンジンとして**ExifTool**(Phil Harveyによる)を使用しています。ExifToolは画像メタデータ処理のゴールドスタンダードであり、数千種類のカメラおよびソフトウェアタイプで数百のメタデータフォーマットをサポートしています。

ExifToolの主な利点:

• 幅広いフォーマットサポート — JPEG、TIFF、PNG、HEIC、ほぼすべてのRAWフォーマットでメタデータの読み書き
• 標準準拠 — EXIF、IPTC、XMP標準を完全にサポート
• 信頼できる — 世界中のプロの写真家や研究者に使用されています
• 完全なUnicode対応 — UTF-8を介してすべてのメタデータフィールドの非ラテン文字を処理

家族史メタデータ作業部会(FHMWG)¶

Tag That Photoは、**家族史メタデータ作業部会(FHMWG)**の推奨を支持しており、これは家族史研究者が大切にする重要なメタデータ領域(名前、日付、場所、出来事、キャプション)に焦点を当てた共同作業です。IPTC、XMP、EXIFなどの既存の標準を使って画像ファイルに直接メタデータを埋め込むことで、TTPは将来の世代のために家族の歴史情報を保存する役割を果たします。

詳細情報はこちらhttps://savemetadata.org/

TTPで使用されるメタデータ標準¶

保管場所¶

JPEG画像のために¶

メタデータは画像ファイル内に複数の形式で直接埋め込まれています: - EXIF - カメラおよび技術データ - IPTC - 記述情報(キーワード、キャプション) - XMP - モダン拡張可能フォーマット(フェイス領域を含む)

サイドカー読み取り:TTPはJPEGがあれば、.xmpサイドカーとJPEGを同時に読み込みます。これにより、TTPが非組み込みモードに設定されている間に作成されたタグは、同期モードに戻っても常に表示されます。

サイドカー書き込み:同期モード(デフォルト)では、TTPはメタデータを直接JPEGファイルに書き込みます。もしJPEGと一緒にサイドカーがすでに存在しているなら、TTPも同期を保つために更新します。TTPは同期モードでJPEG用の新しいサイドカーを作成しません。JPEGサイドカーを作成するには、非組み込みモード(下記のエクスポート設定参照)を有効にしてください。

TIFF イメージズのために¶

メタデータはTIFFファイル(EXIF、IPTC、XMP)に直接埋め込まれています。TTPはまた、すべてのTIFFに対応するXMPサイドカーファイルを書き込み、両者を自動的に同期させます。これを管理する必要はありません — TTPは存在しないサイドカーを作成し、書き込みのたびに両方を更新します。

PNGおよびRAW画像のために¶

メタデータは**XMPサイドカーファイル**にのみ格納されます: - 画像と同じファイル名で拡張子.xmp(例:photo.cr2.xmp) - プレーンテキストXML形式 - 通常20KB未満のサイズ - 人間が読みやすい(任意のテキストエディタで開ける)

重要な点: これらの画像を移動する際は、必ずファイルと一緒に.xmpファイルを動かしてください!

HEICイメージズのために¶

TTPは、Apple PhotosやiOSカメラなど他のアプリケーションによってHEICファイルに書き込まれた埋め込みXMPを読み込み、サイドカーがあればそれに付随する.xmpも読み込みます。

同期モード**では、TTPは.heicファイル内の埋め込みXMPと .xmpサイドカーファイルの両方にメタデータを書き込み、自動的に同期を保ちます。(埋め込みHEIC書き込みは新たに追加され、テストが必要です。)

**非組み込みモード**では、TTPは.xmpサイドカーにのみ書き込み、元の.heicファイルは変更されません。

重要: TTPの管理フォルダからHEIC画像を移動する際は、必ずそれらと一緒に.xmpサイドカーファイルを移動してください。

サイドカーサポート概要¶

HEIC†組み込み書き込みは新たに追加され、テストが必要です。

地域基準に直面¶

TTPは**3**のフェイスリージョンメタデータ標準をサポートし、最大限の互換性のために3つすべてに同時に書き込みを行います。

1.メタデータ作業部会(MWG)¶

• 業界全体の標準
• Adobe、Appleなどがサポートしています
• 最も広範なアプリケーション互換性
• 中心点正規化座標(0.0–1.0)を使用します
• 参考文献:MWG Guidelines PDF

2.Microsoft Photo Region Info(MPRI)¶

• Microsoft Photo Galleryで使用
• Windowsエクスプローラーはこれらの領域を読み取り表示します
• Windowsエコシステム互換性に優れている
• **左上隅座標**を使用
• 仕様:Microsoft Photo 1.2 Schema

3.IPTC拡張(ImageRegion)¶

• IPTCフォトメタデータ標準の一部
• 新しい写真用途での採用拡大
• 面領域座標と簡単なPersonInImage名リストの両方を含みます
• 中心点正規化座標(MWGと同じ)を使用しています
• 参考文献:IPTC Photo Metadata

推奨事項: 最大限の互換性を得るために設定で3つのフォーマットすべてを有効にしてください。

TTPはまた、現在の向きデータを使って面座標を正規化し、非標準的なEXIF向きメタデータを持つ画像のドリフトを防ぎます。

TTPがメタデータを読み取る方法¶

TTPが画像をスキャンする際、優先度ベースのフォールバックシステムを使って複数のタグ位置から読み込みます。優先順位リストで最初に見つけた空でない値が使われます。

TTPがメタデータ変更を検出する方法¶

TTPは、スキャン中にこれらの信号のいずれかが検出された際にメタデータを再読み込むファイルとしてマークします:

1. 画像ファイルの最終書き込みタイムスタンプが変更されました
2. .xmpのサイドカーが新たに作成されたか、タイムスタンプが変更された
3. 画像のXMP:MetadataDateはTTPに保存された標準メタデータ日付と異なる

メタデータトリガーによる再読が実効的な標準値(例:キーワード、位置、タイトルフィールド)を変更した場合、対応するセクションはダーティマークされ、調整されたDB状態をファイルにエクスポートできます。

追加のワークフロー動作:

• 保留中のメタデータ変更は、値が実際に異なる場合にのみ表示されます
• 新たにスキャンされたファイルは、メタデータ設定で必要な場合にのみエクスポートのキューに入ります
• フォルダスキャン後、TTPは保留中のメタデータ更新を即座に適用するよう促すことができます

読書優先¶

タイトル¶

(優先順位順)から読む:

1. XMP-dc:Title / XMP:Title
2. IPTC:Headline

説明(キャプション)¶

(優先順位順)から読む:

1. XMP-dc:Description / XMP:Description
2. IPTC:Caption-Abstract

キーワード¶

(優先順位で、すべての情報源を統合)から読んでください:

1. XMP-dc:Subject
2. XMP:Subject
3. IPTC:Keywords

論理: すべてのキーワードリストは単一の重複除去リストに統合されます。人名に一致するキーワードは「キーワードとして名前をエクスポート」を有効にしない限り、人として(キーワードではなく)保存されます。

デートの約束¶

(優先順位順)から読む:

1. XMP-photoshop:DateCreated
2. XMP:DateCreated
3. EXIF:DateTimeOriginal
4. EXIF:CreateDate

日付精度オプションがサポートされるようになりました:

• フルデート+時間
• デートのみ
• 年のみ(歴史アーカイブに有用)

GPS座標¶

(優先順位順)から読む:

1. EXIF:GPSLatitude、EXIF:GPSLongitude(参照タグ付き)
2. XMP:GPSLatitude、XMP:GPSLongitude

対応GPSフォーマット:

• DMS: 39 deg 46' 54.12" N
• コンパクト:39,46,54.12N
• 小数点:39.7817または-89.6501

有効なGPS記録となるには、緯度と経度の両方が存在する必要があります。高度は任意です。

場所(住所)¶

(優先順位順)から読む:

1. 構造化IPTC拡張LocationShownオブジェクト — 市、州/州、国、サブロケーション、自由形式の会場名(LocationName)を一つのユニットとして抽出します
2. フォールバックとしてのフラットXMP/IPTCタグ:XMP-photoshop:City、IPTC:City、XMP-photoshop:State、IPTC:Province-State、IPTC:Country-PrimaryLocationNameなど。

地域に顔を向けて¶

** から(優先順に — 重複を避けるために1つのソースのみ使用)から読み込む:**

1. MWG(XMP-mwg-rs:RegionInfo)
2. Microsoft MP(XMP-MP:RegionInfoMP)
3. IPTCエクステンション(XMP-iptcExt:ImageRegion)

論理: リージョンはリージョンを含む最も優先度の高いソースから読み取られます。これにより、ファイルに複数のフォーマットの領域が含まれている場合に重複面が現れるのを防ぎます。

作者/創造者¶

(優先順位順)から読む:

1. XMP-dc:Creator / XMP:Creator
2. EXIF:Artist

著作権¶

(優先順位順)から読む:

1. XMP-dc:Rights / XMP:Rights
2. EXIF:Copyright

TTPがメタデータを書く方法¶

メタデータ書き込みが有効になると、TTPはExifToolを使ってタグを画像ファイル(またはそのXMPサイドカー)内の標準的な位置に書き込みます。

メタデータが位置を書き込む¶

構造化されたロケーションライティング¶

TTPは、すべての位置情報—都市、州/州、国、サブロケーション(会場住所)、自由形式の場所名—を単一の構造化されたIPTC拡張LocationShownオブジェクトとして書き込みます。これは各フィールドを別々のタグに書き込むよりも標準化されており、IPTC準正アプリケーションとの互換性が向上します。

TTPが書いた例:

LocationShown[0].City             = Springfield
LocationShown[0].ProvinceState    = Illinois
LocationShown[0].CountryName      = United States
LocationShown[0].Sublocation      = Lincoln Home
LocationShown[0].LocationName     = Abraham Lincoln's House

Sublocationフィールドには具体的な住所または会場名が記載され、LocationNameフィールドには場所の自由な記述名が記されています。

位置情報編集の改善により、構造化された住所データと使いやすい位置タイトルの両方を同時に管理しやすくなりました。

メタデータ作成プロセス¶

執筆は背景のプロセスとして行われます:

1. 顔にタグ付けしたり、TTPでキーワードを追加したりします
2. 変更はすぐにTTPデータベースに保存されます
3. バックグラウンドサービスが画像のメタデータ更新をキューに留めます
4. システムがアイドル状態のとき、メタデータが画像ファイルに書き込まれます
5. XMPメタデータの日付が修正の追跡のために更新されます

優先度: ユーザーの操作は常にバックグラウンドメタデータの書き込みよりも優先されます。

大規模なバッチに対しては、TTPが書き込みキュー全体で共有のExifToolセッションをアクティブに保ち、バルクメタデータ操作時のファイルあたりのオーバーヘッドを大幅に削減します。

メタデータ統合と調整¶

TTPが画像のインポートや再スキャン時にメタデータを読み取る際、ファイルのメタデータをデータベースにすでに保存されているものと統合します。目標はタグ付け作業を失わず、画像ファイルから新しい情報を取り戻すことです。

重複物理ファイルの標準モデル¶

複数の物理ファイルが同じピクセルハッシュと向きを持つ場合、TTPはそれらを複数のImageFilesを付随する1つの論理画像(TtpImage)として扱います。

• メタデータは1つの標準的なDBレコードに照合されます
• 再インポートがメタデータ駆動の変更を検出した場合、その標準レコード上で汚れたセクションがフラグ付けされます
• メタデータエクスポートを実行する際、TTPは調整された正準状態をその論理画像にリンクされたすべての物理コピーに書き戻します

一般的な合流ルール¶

日付の不一致の扱い¶

もしTTPが画像ファイル内の日付とデータベースに保存されている日付が異なる場合、次のようになります:

1. 既存のデータベース日付を標準(表示)日付として保持する
2. ユーザーレビュー用の代替日を記録する
3. UIに不一致インジケーターが表示され、競合を解決できるようにします

年限定の日付(歴史的写真)¶

Adobe Photoshopを含む一部のアプリケーションは、歴史的な写真の年のみの日付を保存し、完全な日付と時間ではなく"1922"だけを書き込むことがあります。TTPはこれを優雅に処理しています:

• "1922"のような年のみの値は、内部的にはその年の1月1日の深夜に*と解釈されます
• 不一致検出の場合、**同年の1月1日深夜0時と1月1日正午**は**同等**として扱われ、矛盾は報告されません
• これにより、異なるアプリケーションが同じ歴史的年のみの日付をわずかに異なる方法で正規化した際に誤った不一致警告が出るのを防ぐことができます

例:

Photoshop writes:  "1922"              → interpreted as 1922-01-01 00:00
Another app has:   1922:01:01 12:00:00 → interpreted as 1922-01-01 12:00

Result: No discrepancy reported (year-only equivalence rule applied)

UI内で: 日付が1月1日深夜の真夜中の場合、TTPは「1922年1月1日 午前0時」ではなく単に1922として表示でき、歴史的な写真の見た目がよりきれいになります。

インポート中のあいまいな名前の照合¶

画像メタデータ(フェイスリージョンタグ、PersonInImage、キーワード)から人物名を読み取る際、TTPは**ファジィな名前マッチング**を用いて、データベース内の既存の人物と名前をリンクします:

• 類似度閾値:0.90(90%の一致が必要)
• わずかな綴り間違いや別形などの小さな名前の変項を扱う
• 世代別接尾辞(Sr、Jr、I、II、IIIなど)には特別な扱いを適用します。これらはアイデンティティクリティカルとして扱われ、ベース名が同一であっても異なる接尾辞間でマッチングされることはありません
• 閾値で一致しない場合、新しい人物記録が自動的に作成されます

エクスポート設定(書かれるもの)¶

エクスポート時にどのメタデータフィールドをTTPが書き込むかを正確にコントロールできます。これらの設定は**メタデータ>設定**にあります。

ヒント: Adobe Lightroom、Apple Photos、その他キーワードリストから名前を読み取るアプリケーションとの互換性のために**キーワードとして名前をエクスポート**を有効にしてください。

メタデータ書き込みモード:同期と非組み込み¶

TTPは**非組み込みメタデータモード**設定で制御される2つのメタデータ書き込みモードをサポートしています。

これらのモードは**画像メタデータエクスポート**がオンの場合にのみ適用されます。画像メタデータのエクスポートがオフの場合、TTPはどちらのモードでもメタデータを書き込みません。

同期モード(デフォルト — 非埋め込みオフ)¶

TTPは元の画像ファイルに直接メタデータを書き込みます。TTPは組み込みフォーマットとサイドカーフォーマットの両方をサポートしており、それらを自動的に同期させます。

最適:Windowsエクスプローラー、モバイルアプリ、EXIFを直接読み取る他のソフトウェアでGPSや日付のメタデータを閲覧したいユーザー。

非組み込みモード(非組み込みモードオン)¶

TTPは元の画像ファイルを変更しません。すべてのメタデータは.xmpサイドカーファイルにのみ書き込まれます。

• 組み込みEXIFおよび組み込みXMP書き込みは完全にスキップされます。
• 存在しない場合、各画像の横に自動的に.xmpサイドカーが作成されます。
• JPEGを含むすべてのフォーマットに対応しています。

最適:アーカイブやオリジナル保存が必要なユーザー、またはオリジナルファイルの改変が認められないワークフローのユーザー。

GPSと日付のトレードオフ:非組み込みモードでは、GPS座標と取得した日付はサイドカーにのみ保存されます。EXIFのみを読み込むアプリケーション(Windowsエクスプローラーやほとんどのモバイルアプリ)は、GPSの位置情報や日付情報を表示しません。

モード切り替え:同期から非組み込みに切り替えても、TTPがすでに書き込んだファイルから埋め込みデータが遡って削除されるわけではありません。将来の書き込みはサイドカーのみに入ります。

XMP サイドカー命名規則 (2026年6月新機能)¶

設定にサイドカー書き込み用の XMP sidecar naming convention セレクターが追加されました: - Auto (Recommended): RAW は filename.xmp、その他は filename.ext.xmp。 - Modern: 常に filename.ext.xmp。 - Legacy: 常に filename.xmp (Adobe Lightroom Classic 互換に推奨)。 サイドカーが既にある場合、TTP は既存のファイル名を維持し、規則変更後の重複/孤立サイドカーを防ぎます。

メタデータ書き込み失敗の追跡と自動再試行 (2026年6月新機能)¶

ファイルのメタデータエクスポートが失敗すると、TTP は失敗状態を記録し、そのファイルへの繰り返し書き込みを一時的に抑制します。 後で元画像またはサイドカーが変わると、失敗状態をクリアし、自動的に再キューします。 これにより背景での無駄な繰り返しを減らしつつ、阻害要因が解消されれば自動復旧します。

2026年7月の改善: - ライブラリフォルダが一時的に利用できない場合(切断されたドライブなど)、メタデータ書き込みは待機し、フォルダ復帰後に続行します(毎回ハード失敗とはみなしません) - ファイルが既に正しいメタデータを持っている場合は、書き込みエラーとして報告しません - 別プログラム(または Tag That Photo 自身)が書き込みや回転中に一時的に写真をロックした場合、変更は保持され、直後に再試行されます

HEIC 向きと GPS 同期の改善 (2026年6月新機能)¶

HEIC のプロキシ向き処理が強化され、回転に敏感なワークフロー後も顔領域が正しく揃います。 GPS 同期は、実運用の修正シナリオに基づきファイルメタデータとデータベースの位置値をより良く整合させます。

拡張された位置情報の相互運用書き込み (2026年6月新機能)¶

構造化 IPTC LocationShown に加え、Adobe ツール等での下流互換のため Photoshop/IPTC Core の位置フィールドも書き込みます。 TTP で位置データを削除すると、同じ書き込みサイクルで対応する互換フィールドもクリアされます。

タグの未来に備えて¶

なぜ基準が重要なのか¶

MWG、Microsoft、IPTCの標準を使ってフェイスタグを書き込むことで、あなたのタグは以下の通りになります:

• ベンダー変更を生き延びる - TTPにロックされていない
• 他の用途での作業 - 以下の互換性表を参照してください
• アクセス可能に保つ - XMLテキスト形式で、バイナリではありません
• 業界の方向性に従う - MWGは広く採用されています;IPTCエクステンションの急速な成長

メタデータの検証¶

メタデータは無料のツールを使って確認できます:

ExifTool(コマンドライン)¶

Phil Harveyによるメタデータ読み書き用の無料ユーティリティ — TTPが内部で使っているのと同じツールです。

用途: - 画像内のすべてのメタデータを閲覧 - メタデータをCSVにエクスポートする - 破損したメタデータの修復 - バッチメタデータ操作

ダウンロード:https://exiftool.org/

クイックチェックコマンド:

exiftool -j -struct filename.jpg

XnViewMP(グラフィカルインターフェース)¶

優れたメタデータ表示を備えた無料の画像ビューア。

特徴: - ビジュアルメタデータブラウザ - XMPサイドカーの取り扱い - 必要に応じてメタデータを剥奪可能 - バッチ操作のサポート

ダウンロード:www.xnview.com

データ品質チェック¶

**Stats**タブには**データ品質**セクションがあり、Statsページを開くたびに複数回チェックされます:

フォルダスキャン完了後、TTPは「統計>データ品質」セクションの確認を促し、検出された問題を即座に解決するよう促します。

クロスアプリケーション互換性{ #cross-application-compatibility }¶

TTPタグを読み取るアプリケーション¶

注: PersonInImageタグは、TTPが各画像に書き込む人物名の簡単なリストであり、フルフェイス領域座標標準をサポートしないアプリケーションにとって有用なバックアップを提供します。これらのアプリケーションは写真に写っている人物を表示できます。

パート5終了:メタデータと技術的詳細

パート6へ続き:トラブルシューティングと付録...