指定されたバンドまたはメタデータは、コレクション内の画像からソース画像に追加されます。バンドまたはメタデータがすでに存在する場合は、上書きされます。一致する画像が見つからない場合、新しいバンドまたは更新されたバンドは完全にマスクされ、新しいメタデータまたは更新されたメタデータは null になります。出力フットプリントは、ソース画像のフットプリントと同じになります。
ソース画像とコレクション内の画像に特定の同等のメタデータ プロパティがある場合、一致と判定されます。複数のコレクション画像が一致する場合は、選択されるコレクション画像は任意です。デフォルトでは、画像は「system:index」メタデータ プロパティで照合されます。
このリンク機能は、指定された共有メタデータ プロパティに基づいてターゲット画像にバンドを追加するための便利なメソッドです。同じソース画像に異なる処理やプロダクト生成を適用するコレクションのリンクをサポートすることを目的としています。「結合」と呼ばれるより表現力豊かなリンクについては、https://developers.google.com/earth-engine/guides/joins_intro をご覧ください。
| 用途 | 戻り値 |
|---|---|
Image.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName) | 画像 |
| 引数 | タイプ | 詳細 |
|---|---|---|
これ: input | 画像 | ソース画像は、コレクション内の一致する画像にリンクされます。 |
imageCollection | ImageCollection | ソースと一致する画像を抽出するために検索される画像コレクション。 |
linkedBands | オブジェクト、デフォルト: null | 一致する画像から追加または更新するバンド名またはバンド名のリスト。 |
linkedProperties | オブジェクト、デフォルト: null | 一致する画像から追加または更新するメタデータ プロパティまたはプロパティのリスト。 |
matchPropertyName | 文字列、デフォルト: "system:index" | 照合条件として使用するメタデータ プロパティ名。 |