إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.Join.saveBest
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض عملية الربط هذه كل عنصر من المجموعة الأولى مع عنصر مطابق من المجموعة الثانية. تتم إضافة التطابق الذي يتضمّن أفضل مقياس ربط إلى كل نتيجة كسمة إضافية. يتم إنشاء مقاييس الربط عند استخدام الفلترَين withinDistance أو maxDifference كشرط ربط.
| الاستخدام | المرتجعات |
|---|
ee.Join.saveBest(matchKey, measureKey, outer) | الانضمام |
| الوسيطة | النوع | التفاصيل |
|---|
matchKey | سلسلة | المفتاح المستخدَم لحفظ نتيجة المطابقة |
measureKey | سلسلة | المفتاح المستخدَم لحفظ مقياس شرط الربط في المطابقة |
outer | قيمة منطقية، القيمة التلقائية: false | في حال ضبط القيمة على "صحيح"، سيتم تضمين الصفوف الأساسية التي لا تتطابق مع أي صفوف في النتيجة. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe \u003ccode\u003esaveBest\u003c/code\u003e join pairs elements from two collections based on the best match according to a specified measure.\u003c/p\u003e\n"],["\u003cp\u003eA join measure, like distance or difference, is calculated when using \u003ccode\u003ewithinDistance\u003c/code\u003e or \u003ccode\u003emaxDifference\u003c/code\u003e filters in the join condition.\u003c/p\u003e\n"],["\u003cp\u003eThe best match and its corresponding measure are added as properties to the result using specified keys (\u003ccode\u003ematchKey\u003c/code\u003e, \u003ccode\u003emeasureKey\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eOptionally, unmatched primary elements can be included in the output by setting the \u003ccode\u003eouter\u003c/code\u003e parameter to \u003ccode\u003etrue\u003c/code\u003e.\u003c/p\u003e\n"]]],["This describes a join operation that pairs elements from two collections. It identifies the best match between elements based on filters like `withinDistance` or `maxDifference`, storing this match in a specified `matchKey`. The quality of the match is stored under `measureKey`. The `outer` argument determines if unmatched elements from the first collection are included in the output. The function, `ee.Join.saveBest`, returns a join object.\n"],null,["# ee.Join.saveBest\n\nReturns a join that pairs each element from the first collection with a matching element from the second collection. The match with the best join measure is added to each result as an additional property. Join measures are produced when withinDistance or maxDifference filters are used as the join condition.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------------------------------|---------|\n| `ee.Join.saveBest(matchKey, measureKey, `*outer*`)` | Join |\n\n| Argument | Type | Details |\n|--------------|-------------------------|-----------------------------------------------------------------------|\n| `matchKey` | String | The key used to save the match. |\n| `measureKey` | String | The key 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. |"]]
