إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.Geometry.MultiPoint.convexHull
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض هذه الدالة الهيكل الخارجي المحدّب للشكل الهندسي المحدّد. إنّ الغلاف المحدّب لنقطة واحدة هو النقطة نفسها، والغلاف المحدّب للنقاط الخطية هو خط، والغلاف المحدّب لكل ما عدا ذلك هو مضلّع. يُرجى العِلم أنّ المضلّع المنحطّ الذي تقع جميع رؤوسه على الخط نفسه سيؤدي إلى إنشاء قطعة مستقيمة.
الاستخدام | المرتجعات |
---|
MultiPoint.convexHull(maxError, proj) | هندسة |
الوسيطة | النوع | التفاصيل |
---|
هذا: geometry | هندسة | تحسب هذه الدالة الهيكل الخارجي المحدّب للشكل الهندسي. |
maxError | ErrorMargin، القيمة التلقائية: null | الحدّ الأقصى لمقدار الخطأ المسموح به عند إجراء أي عملية إعادة إسقاط ضرورية. |
proj | التوقّع، القيمة التلقائية: null | الإسقاط الذي سيتم تنفيذ العملية فيه في حال عدم تحديد ذلك، سيتم تنفيذ العملية في نظام إحداثيات كروي، وستكون المسافات الخطية بالأمتار على الكرة الأرضية. |
أمثلة
محرّر الرموز البرمجية (JavaScript)
// Define a MultiPoint object.
var multiPoint = ee.Geometry.MultiPoint([[-122.082, 37.420], [-122.081, 37.426]]);
// Apply the convexHull method to the MultiPoint object.
var multiPointConvexHull = multiPoint.convexHull({'maxError': 1});
// Print the result to the console.
print('multiPoint.convexHull(...) =', multiPointConvexHull);
// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(multiPoint,
{'color': 'black'},
'Geometry [black]: multiPoint');
Map.addLayer(multiPointConvexHull,
{'color': 'red'},
'Result [red]: multiPoint.convexHull');
إعداد Python
راجِع صفحة
بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python واستخدام
geemap
للتطوير التفاعلي.
import ee
import geemap.core as geemap
Colab (Python)
# Define a MultiPoint object.
multipoint = ee.Geometry.MultiPoint([[-122.082, 37.420], [-122.081, 37.426]])
# Apply the convexHull method to the MultiPoint object.
multipoint_convex_hull = multipoint.convexHull(maxError=1)
# Print the result.
display('multipoint.convexHull(...) =', multipoint_convex_hull)
# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(multipoint, {'color': 'black'}, 'Geometry [black]: multipoint')
m.add_layer(
multipoint_convex_hull,
{'color': 'red'},
'Result [red]: multipoint.convexHull',
)
m
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe \u003ccode\u003econvexHull()\u003c/code\u003e method returns the smallest convex Geometry that contains all the points in the input geometry.\u003c/p\u003e\n"],["\u003cp\u003eIt can be applied to any Geometry object, but is most commonly used with MultiPoint objects.\u003c/p\u003e\n"],["\u003cp\u003eThe result can be a Point, a LineString, or a Polygon depending on the input geometry.\u003c/p\u003e\n"],["\u003cp\u003eOptional parameters \u003ccode\u003emaxError\u003c/code\u003e and \u003ccode\u003eproj\u003c/code\u003e allow control over reprojection and the coordinate system used for calculations.\u003c/p\u003e\n"]]],[],null,["# ee.Geometry.MultiPoint.convexHull\n\nReturns the convex hull of the given geometry. The convex hull of a single point is the point itself, the convex hull of collinear points is a line, and the convex hull of everything else is a polygon. Note that a degenerate polygon with all vertices on the same line will result in a line segment.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|--------------------------------------------------|----------|\n| MultiPoint.convexHull`(`*maxError* `, `*proj*`)` | Geometry |\n\n| Argument | Type | Details |\n|------------------|----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `geometry` | Geometry | Calculates the convex hull of this geometry. |\n| `maxError` | ErrorMargin, default: null | The maximum amount of error tolerated when performing any necessary reprojection. |\n| `proj` | Projection, default: null | The projection in which to perform the operation. If not specified, the operation will be performed in a spherical coordinate system, and linear distances will be in meters on the sphere. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Define a MultiPoint object.\nvar multiPoint = ee.Geometry.MultiPoint([[-122.082, 37.420], [-122.081, 37.426]]);\n\n// Apply the convexHull method to the MultiPoint object.\nvar multiPointConvexHull = multiPoint.convexHull({'maxError': 1});\n\n// Print the result to the console.\nprint('multiPoint.convexHull(...) =', multiPointConvexHull);\n\n// Display relevant geometries on the map.\nMap.setCenter(-122.085, 37.422, 15);\nMap.addLayer(multiPoint,\n {'color': 'black'},\n 'Geometry [black]: multiPoint');\nMap.addLayer(multiPointConvexHull,\n {'color': 'red'},\n 'Result [red]: multiPoint.convexHull');\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\n# Define a MultiPoint object.\nmultipoint = ee.Geometry.MultiPoint([[-122.082, 37.420], [-122.081, 37.426]])\n\n# Apply the convexHull method to the MultiPoint object.\nmultipoint_convex_hull = multipoint.convexHull(maxError=1)\n\n# Print the result.\ndisplay('multipoint.convexHull(...) =', multipoint_convex_hull)\n\n# Display relevant geometries on the map.\nm = geemap.Map()\nm.set_center(-122.085, 37.422, 15)\nm.add_layer(multipoint, {'color': 'black'}, 'Geometry [black]: multipoint')\nm.add_layer(\n multipoint_convex_hull,\n {'color': 'red'},\n 'Result [red]: multipoint.convexHull',\n)\nm\n```"]]