ee.Join.saveFirst
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Renvoie une jointure qui associe chaque élément de la première collection à un élément correspondant de la deuxième collection. La première correspondance est ajoutée au résultat en tant que propriété supplémentaire.
Utilisation | Renvoie |
---|
ee.Join.saveFirst(matchKey, ordering, ascending, measureKey, outer) | Rejoindre |
Argument | Type | Détails |
---|
matchKey | Chaîne | Nom de la propriété utilisée pour enregistrer la correspondance. |
ordering | Chaîne, valeur par défaut : null | Propriété sur laquelle trier les correspondances avant de sélectionner la première. |
ascending | Booléen, valeur par défaut : true | Indique si l'ordre est croissant. |
measureKey | Chaîne, valeur par défaut : null | Nom de propriété facultatif utilisé pour enregistrer la mesure de la condition de jointure sur la correspondance. |
outer | Booléen, valeur par défaut : false | Si la valeur est "true", les lignes principales sans correspondance seront incluses dans le résultat. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eThis function joins two collections by pairing elements based on matching property values.\u003c/p\u003e\n"],["\u003cp\u003eIt prioritizes the first match encountered and appends it as an additional property to the primary collection.\u003c/p\u003e\n"],["\u003cp\u003eUsers can specify sorting criteria for the matches using \u003ccode\u003eordering\u003c/code\u003e and \u003ccode\u003eascending\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eOptionally, it allows saving the measure of the join condition and includes primary rows without matches if \u003ccode\u003eouter\u003c/code\u003e is true.\u003c/p\u003e\n"]]],["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"],null,["# ee.Join.saveFirst\n\nReturns 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.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|------------------------------------------------------------------------------------------|---------|\n| `ee.Join.saveFirst(matchKey, `*ordering* `, `*ascending* `, `*measureKey* `, `*outer*`)` | Join |\n\n| Argument | Type | Details |\n|--------------|-------------------------|----------------------------------------------------------------------------------------|\n| `matchKey` | String | The property name used to save the match. |\n| `ordering` | String, default: null | The property on which to sort the matches before selecting the first. |\n| `ascending` | Boolean, default: true | Whether the ordering is ascending. |\n| `measureKey` | String, default: null | An optional property name used to save the measure of the join condition on the match. |\n| `outer` | Boolean, default: false | If true, primary rows without matches will be included in the result. |"]]