إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ui.Chart.image.regions
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تنشئ هذه الدالة رسمًا بيانيًا من صورة. تستخرِج هذه الدالة قيمة كل نطاق في منطقة واحدة أو أكثر وترسمها.
- المحور X = النطاق المصنّف حسب xProperty (القيمة التلقائية: اسم النطاق).
- المحور Y = ناتج المخفّض.
- السلسلة = المنطقة المصنّفة حسب السمة seriesProperty (القيمة التلقائية: system:index).
تعرض هذه الدالة رسمًا بيانيًا.
| الاستخدام | المرتجعات |
|---|
ui.Chart.image.regions(image, regions, reducer, scale, seriesProperty, xLabels) | ui.Chart |
| الوسيطة | النوع | التفاصيل |
|---|
image | صورة | الصورة المطلوب استخراج قيم النطاقات منها |
regions | Feature|FeatureCollection|Geometry|List<Feature>|List<Geometry>، اختياري | المناطق التي يجب تقليلها القيمة التلقائية هي مساحة الصورة. |
reducer | مخفض، اختياري | الدالة المخفّضة التي تنشئ قيم المحور y يجب أن تعرض قيمة واحدة لكل نطاق. |
scale | رقم، اختياري | تمثّل هذه السمة مقياس البكسل بالمتر. |
seriesProperty | سلسلة، اختياري | السمة التي سيتم استخدامها كتسمية لكل منطقة في وسيلة الإيضاح. القيمة التلقائية هي "system:index". |
xLabels | List<Object>, optional | قائمة بالتصنيفات المستخدَمة للنطاقات على المحور "س". يجب أن يحتوي على عدد العناصر نفسه الموجود في نطاقات الصور. في حال عدم تضمينها، سيتم تصنيف النطاقات بأسمائها. إذا كانت التصنيفات رقمية (مثل الأطوال الموجية)، سيكون المحور السيني متصلاً. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGenerates a chart visualizing the values of image bands within specified regions, plotted against band labels or custom x-axis labels.\u003c/p\u003e\n"],["\u003cp\u003eUsers can define regions for analysis, the reducer for calculating band values, pixel scale, legend labels, and custom x-axis labels for the chart.\u003c/p\u003e\n"],["\u003cp\u003eThe chart's y-axis represents the reducer output, while the x-axis represents either band names or user-defined labels, and separate series are plotted for each region.\u003c/p\u003e\n"],["\u003cp\u003eThe function accepts an image, regions, a reducer, scale, series property for legend labels, and custom x-axis labels as input parameters.\u003c/p\u003e\n"],["\u003cp\u003eIt outputs a chart object displaying the extracted and plotted band values.\u003c/p\u003e\n"]]],[],null,["# ui.Chart.image.regions\n\n\u003cbr /\u003e\n\nGenerates a Chart from an image. Extracts and plots the value of each band in one or more regions.\n\n\u003cbr /\u003e\n\n- X-axis = Band labeled by xProperty (default: band name).\n\n- Y-axis = Reducer output.\n\n- Series = Region labeled by seriesProperty (default: 'system:index').\n\nReturns a chart.\n\n| Usage | Returns |\n|-----------------------------------------------------------------------------------------------------------|----------|\n| `ui.Chart.image.regions(image, `*regions* `, `*reducer* `, `*scale* `, `*seriesProperty* `, `*xLabels*`)` | ui.Chart |\n\n| Argument | Type | Details |\n|------------------|-----------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `image` | Image | Image to extract band values from. |\n| `regions` | Feature\\|FeatureCollection\\|Geometry\\|List\\\u003cFeature\\\u003e\\|List\\\u003cGeometry\\\u003e, optional | Regions to reduce. Defaults to the image's footprint. |\n| `reducer` | Reducer, optional | Reducer that generates the value(s) for the y-axis. Must return a single value per band. |\n| `scale` | Number, optional | The pixel scale in meters. |\n| `seriesProperty` | String, optional | Property to be used as the label for each region in the legend. Defaults to 'system:index'. |\n| `xLabels` | List\\\u003cObject\\\u003e, optional | A list of labels used for bands on the x-axis. Must have the same number of elements as the image bands. If omitted, bands will be labeled with their names. If the labels are numeric (e.g. wavelengths), x-axis will be continuous. |"]]
