Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.ImageCollection.combine
Stay organized with collections
Save and categorize content based on your preferences.
Makes a new collection that is a copy of the images in primary, adding all the bands from the image in secondary with a matching ID. If there are no matching IDs, the resulting collection will be empty. This is equivalent to an inner join on ID with merging of the bands of the result.
Note that this algorithm assumes that for a matching pair of inputs, both have the same footprint and metadata.
| Usage | Returns | ImageCollection.combine(secondary, overwrite) | ImageCollection |
| Argument | Type | Details | this: primary | ImageCollection | The primary collection to join. |
secondary | ImageCollection | The secondary collection to join. |
overwrite | Boolean, default: false | If true, bands with the same name will get overwritten. If false, bands with the same name will be renamed. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["\u003cp\u003eCreates a new image collection by combining images from two input collections based on matching IDs.\u003c/p\u003e\n"],["\u003cp\u003eMerges bands from matching images, resulting in an empty collection if no IDs match.\u003c/p\u003e\n"],["\u003cp\u003eImages with the same ID in both input collections are assumed to have identical footprint and metadata.\u003c/p\u003e\n"],["\u003cp\u003eBand names are preserved by default, but can be overwritten using the \u003ccode\u003eoverwrite\u003c/code\u003e parameter.\u003c/p\u003e\n"]]],["The function combines two `ImageCollections` (`primary` and `secondary`) by performing an inner join based on matching IDs. It copies images from the `primary` collection and adds bands from the `secondary` collection with the corresponding ID. If no matching ID is found, the resulting collection is empty. Band names that are the same can either be renamed or overwritten based on the `overwrite` flag. The function returns a new `ImageCollection`.\n"],null,["# ee.ImageCollection.combine\n\nMakes a new collection that is a copy of the images in primary, adding all the bands from the image in secondary with a matching ID. If there are no matching IDs, the resulting collection will be empty. This is equivalent to an inner join on ID with merging of the bands of the result.\n\n\u003cbr /\u003e\n\nNote that this algorithm assumes that for a matching pair of inputs, both have the same footprint and metadata.\n\n| Usage | Returns |\n|-----------------------------------------------------|-----------------|\n| ImageCollection.combine`(secondary, `*overwrite*`)` | ImageCollection |\n\n| Argument | Type | Details |\n|-----------------|-------------------------|-------------------------------------------------------------------------------------------------------------|\n| this: `primary` | ImageCollection | The primary collection to join. |\n| `secondary` | ImageCollection | The secondary collection to join. |\n| `overwrite` | Boolean, default: false | If true, bands with the same name will get overwritten. If false, bands with the same name will be renamed. |"]]