Earth Engine is introducing
noncommercial quota tiers to safeguard shared compute resources and ensure reliable performance for everyone. All noncommercial projects will need to select a quota tier by
April 27, 2026 or will use the Community Tier by default. Tier quotas will take effect for all projects (regardless of tier selection date) on
April 27, 2026.
Learn more.
ee.Join.saveFirst
Stay organized with collections
Save and categorize content based on your preferences.
Returns a join that pairs each element from the first collection with a matching element from the second collection. The first match is added to the result as an additional property.
| Usage | Returns | ee.Join.saveFirst(matchKey, ordering, ascending, measureKey, outer) | Join |
| Argument | Type | Details | matchKey | String | The property name used to save the match. |
ordering | String, default: null | The property on which to sort the matches before selecting the first. |
ascending | Boolean, default: true | Whether the ordering is ascending. |
measureKey | String, default: null | An optional property name used to save the measure of the join condition on the match. |
outer | Boolean, default: false | If true, primary rows without matches will be included in the result. |
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."],[],["The `ee.Join.saveFirst` function creates a join between two collections, pairing each element from the first with its first matching element from the second. The matched element is stored as a new property, specified by `matchKey`. Matches can be sorted by `ordering` in `ascending` order before the first is selected. `measureKey` can be used to save the measurement of the join. Setting `outer` to true includes unmatched primary rows.\n"]]