お知らせ:
2025 年 4 月 15 日より前に Earth Engine の使用を登録したすべての非商用プロジェクトは、Earth Engine へのアクセスを維持するために
非商用目的での利用資格を確認する必要があります。
ee.ImageCollection.linkCollection
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
このコレクション内の画像を
imageCollection
の一致する画像にリンクします。
このコレクション内の各ソース画像について、指定されたバンドまたはメタデータが、
imageCollection
。バンドまたはメタデータがすでに存在する場合は、上書きされます。一致する画像が見つからない場合、新規または更新されたバンドは完全にマスクされ、新規または更新されたメタデータは null になります。出力フットプリントは、ソース画像のフットプリントと同じになります。
ソース画像と imageCollection
の画像に特定の同等のメタデータ プロパティがある場合、一致と判定されます。複数のコレクション画像が一致する場合は、選択されるコレクション画像は任意です。デフォルトでは、画像は「system:index」メタデータ プロパティで照合されます。
このリンク機能は、指定された共有メタデータ プロパティに基づいてターゲット画像にバンドを追加するための便利なメソッドです。同じソース画像に異なる処理やプロダクト生成を適用するコレクションのリンクをサポートすることを目的としています。より表現力豊かなリンク(
'joining' をご覧ください(https://developers.google.com/earth-engine/guides/joins_intro)。
リンクされた画像コレクションを返します。
用途 | 戻り値 |
---|
ImageCollection.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName) | ImageCollection |
引数 | タイプ | 詳細 |
---|
これ: imagecollection | ImageCollection | ImageCollection インスタンス。 |
imageCollection | ImageCollection | このコレクションから一致するものを検索した画像コレクション。 |
linkedBands | List<String>(省略可) | 一致する画像から追加または更新するバンド名の省略可能なリスト。 |
linkedProperties | List<String>(省略可) | 一致する画像から追加または更新するメタデータ プロパティのオプション リスト。 |
matchPropertyName | 文字列、省略可 | 照合条件として使用するメタデータ プロパティ名。デフォルトは「system:index」です。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eThe \u003ccode\u003elinkCollection\u003c/code\u003e function connects images in one collection to matching images in another based on shared metadata.\u003c/p\u003e\n"],["\u003cp\u003eIt adds or updates bands and metadata in the first collection using information from matching images in the second collection.\u003c/p\u003e\n"],["\u003cp\u003eMatching images are identified by a specified metadata property, with "system:index" as the default.\u003c/p\u003e\n"],["\u003cp\u003eUnmatched images will have masked bands and null metadata for newly added or updated properties.\u003c/p\u003e\n"],["\u003cp\u003eThis function simplifies linking images derived from the same source but with different processing applied.\u003c/p\u003e\n"]]],[],null,["# ee.ImageCollection.linkCollection\n\n\u003cbr /\u003e\n\nLinks images in this collection to matching images from `imageCollection`.\n\n\u003cbr /\u003e\n\nFor each source image in this collection, any specified bands or metadata will be added to the source image from the matching image found in\n\n`imageCollection`. If bands or metadata are already present, they will be overwritten. If matching images are not found, any new or updated bands will be fully masked and any new or updated metadata will be null. The output footprint will be the same as the source image footprint.\n\nMatches are determined if a source image and an image in `imageCollection` have a specific equivalent metadata property. If more than one collection image would match, the collection image selected is arbitrary. By default, images are matched on their 'system:index' metadata property.\n\nThis linking function is a convenience method for adding bands to target images based on a specified shared metadata property and is intended to support linking collections that apply different processing/product generation to the same source imagery. For more expressive linking known as\n\n'joining', see https://developers.google.com/earth-engine/guides/joins_intro.\n\nReturns the linked image collection.\n\n| Usage | Returns |\n|-------------------------------------------------------------------------------------------------------------------|-----------------|\n| ImageCollection.linkCollection`(imageCollection, `*linkedBands* `, `*linkedProperties* `, `*matchPropertyName*`)` | ImageCollection |\n\n| Argument | Type | Details |\n|-------------------------|--------------------------|------------------------------------------------------------------------------------|\n| this: `imagecollection` | ImageCollection | The ImageCollection instance. |\n| `imageCollection` | ImageCollection | The image collection searched to find matches from this collection. |\n| `linkedBands` | List\\\u003cString\\\u003e, optional | Optional list of band names to add or update from matching images. |\n| `linkedProperties` | List\\\u003cString\\\u003e, optional | Optional list of metadata properties to add or update from matching images. |\n| `matchPropertyName` | String, optional | The metadata property name to use as a match criteria. Defaults to \"system:index\". |"]]