إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.Geometry.BBox.convexHull
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض هذه الدالة الهيكل الخارجي المحدّب للشكل الهندسي المحدّد. إنّ الغلاف المحدّب لنقطة واحدة هو النقطة نفسها، والغلاف المحدّب للنقاط الخطية هو خط، والغلاف المحدّب لكل ما عدا ذلك هو مضلّع. يُرجى العِلم أنّ المضلّع المنحطّ الذي تقع جميع رؤوسه على الخط نفسه سيؤدي إلى إنشاء قطعة مستقيمة.
الاستخدام | المرتجعات |
---|
BBox.convexHull(maxError, proj) | هندسة |
الوسيطة | النوع | التفاصيل |
---|
هذا: geometry | هندسة | تحسب هذه الدالة الهيكل الخارجي المحدّب للشكل الهندسي. |
maxError | ErrorMargin، القيمة التلقائية: null | الحدّ الأقصى لمقدار الخطأ المسموح به عند إجراء أي عملية إعادة إسقاط ضرورية. |
proj | التوقّع، القيمة التلقائية: null | الإسقاط الذي سيتم تنفيذ العملية فيه في حال عدم تحديد ذلك، سيتم تنفيذ العملية في نظام إحداثيات كروي، وستكون المسافات الخطية بالأمتار على الكرة الأرضية. |
أمثلة
محرّر الرموز البرمجية (JavaScript)
// Define a BBox object.
var bBox = ee.Geometry.BBox(-122.09, 37.42, -122.08, 37.43);
// Apply the convexHull method to the BBox object.
var bBoxConvexHull = bBox.convexHull({'maxError': 1});
// Print the result to the console.
print('bBox.convexHull(...) =', bBoxConvexHull);
// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(bBox,
{'color': 'black'},
'Geometry [black]: bBox');
Map.addLayer(bBoxConvexHull,
{'color': 'red'},
'Result [red]: bBox.convexHull');
إعداد Python
راجِع صفحة
بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python واستخدام
geemap
للتطوير التفاعلي.
import ee
import geemap.core as geemap
Colab (Python)
# Define a BBox object.
bbox = ee.Geometry.BBox(-122.09, 37.42, -122.08, 37.43)
# Apply the convexHull method to the BBox object.
bbox_convex_hull = bbox.convexHull(maxError=1)
# Print the result.
display('bbox.convexHull(...) =', bbox_convex_hull)
# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(bbox, {'color': 'black'}, 'Geometry [black]: bbox')
m.add_layer(
bbox_convex_hull, {'color': 'red'}, 'Result [red]: bbox.convexHull'
)
m
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eReturns the smallest convex Geometry that contains all the points in the input Geometry.\u003c/p\u003e\n"],["\u003cp\u003eAccepts optional arguments for maximum error and projection for reprojection.\u003c/p\u003e\n"],["\u003cp\u003eReturns the input Geometry itself if it is a single point or a line.\u003c/p\u003e\n"],["\u003cp\u003eA degenerate polygon with all vertices on the same line will be reduced to a line segment.\u003c/p\u003e\n"],["\u003cp\u003eUseful for finding the outer boundary of a set of points or geometries.\u003c/p\u003e\n"]]],[],null,["# ee.Geometry.BBox.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| BBox.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 BBox object.\nvar bBox = ee.Geometry.BBox(-122.09, 37.42, -122.08, 37.43);\n\n// Apply the convexHull method to the BBox object.\nvar bBoxConvexHull = bBox.convexHull({'maxError': 1});\n\n// Print the result to the console.\nprint('bBox.convexHull(...) =', bBoxConvexHull);\n\n// Display relevant geometries on the map.\nMap.setCenter(-122.085, 37.422, 15);\nMap.addLayer(bBox,\n {'color': 'black'},\n 'Geometry [black]: bBox');\nMap.addLayer(bBoxConvexHull,\n {'color': 'red'},\n 'Result [red]: bBox.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 BBox object.\nbbox = ee.Geometry.BBox(-122.09, 37.42, -122.08, 37.43)\n\n# Apply the convexHull method to the BBox object.\nbbox_convex_hull = bbox.convexHull(maxError=1)\n\n# Print the result.\ndisplay('bbox.convexHull(...) =', bbox_convex_hull)\n\n# Display relevant geometries on the map.\nm = geemap.Map()\nm.set_center(-122.085, 37.422, 15)\nm.add_layer(bbox, {'color': 'black'}, 'Geometry [black]: bbox')\nm.add_layer(\n bbox_convex_hull, {'color': 'red'}, 'Result [red]: bbox.convexHull'\n)\nm\n```"]]