إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.Join.saveFirst
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض عملية الربط هذه كل عنصر من المجموعة الأولى مع عنصر مطابق من المجموعة الثانية. تتم إضافة أول تطابق إلى النتيجة كسمة إضافية.
| الاستخدام | المرتجعات |
|---|
ee.Join.saveFirst(matchKey, ordering, ascending, measureKey, outer) | الانضمام |
| الوسيطة | النوع | التفاصيل |
|---|
matchKey | سلسلة | اسم السمة المستخدَمة لحفظ نتيجة المطابقة |
ordering | سلسلة، القيمة التلقائية: null | السمة التي سيتم ترتيب النتائج المطابقة حسبها قبل اختيار النتيجة الأولى |
ascending | قيمة منطقية، القيمة التلقائية: true | ما إذا كان الترتيب تصاعديًا. |
measureKey | سلسلة، القيمة التلقائية: null | اسم سمة اختياري يُستخدَم لحفظ مقياس شرط الربط في المطابقة. |
outer | قيمة منطقية، القيمة التلقائية: false | في حال ضبط القيمة على "صحيح"، سيتم تضمين الصفوف الأساسية التي لا تتطابق مع أي صفوف في النتيجة. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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. |"]]
