ee.Image.linkCollection

ソース画像を画像コレクションの一致する画像にリンクします。

指定されたバンドまたはメタデータは、コレクション内の画像からソース画像に追加されます。バンドまたはメタデータがすでに存在する場合は、上書きされます。一致する画像が見つからない場合、新しいバンドまたは更新されたバンドは完全にマスクされ、新しいメタデータまたは更新されたメタデータは null になります。出力フットプリントはソース画像のフットプリントと同じになります。

ソース画像とコレクション内の画像に特定の同等のメタデータ プロパティがある場合、一致と見なされます。複数のコレクション画像が一致する場合、選択されるコレクション画像は任意です。デフォルトでは、画像は 'system:index' メタデータ プロパティに基づいて照合されます。

このリンク機能は、指定された共有メタデータ プロパティに基づいてターゲット画像にバンドを追加する便利なメソッドです。同じソース画像に異なる処理やプロダクト生成を適用するコレクションのリンクをサポートすることを目的としています。「結合」と呼ばれるより表現力豊かなリンクについては、https://developers.google.com/earth-engine/guides/joins_intro をご覧ください。

用途	戻り値
Image.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName)	画像

引数	タイプ	詳細
this: input	画像	コレクション内の一致する画像にリンクされるソース画像。
imageCollection	ImageCollection	ソースに一致する画像を抽出するために検索される画像コレクション。
linkedBands	オブジェクト、デフォルト: null	一致する画像から追加または更新するバンド名またはバンド名のリスト。
linkedProperties	オブジェクト、デフォルト: null	一致する画像から追加または更新するメタデータ プロパティまたはプロパティのリスト。
matchPropertyName	文字列、デフォルト: "system:index"	一致条件として使用するメタデータ プロパティ名。