ee.Geometry.Polygon.convexHull

تعرض هذه الدالة الهيكل الخارجي المحدّب للشكل الهندسي المحدّد. إنّ الغلاف المحدّب لنقطة واحدة هو النقطة نفسها، والغلاف المحدّب للنقاط الخطية هو خط، والغلاف المحدّب لكل ما عدا ذلك هو مضلّع. يُرجى العِلم أنّ المضلّع المنحطّ الذي تقع جميع رؤوسه على الخط نفسه سيؤدي إلى إنشاء قطعة مستقيمة.

الاستخدام	المرتجعات
Polygon.convexHull(maxError, proj)	هندسة

الوسيطة	النوع	التفاصيل
هذا: geometry	هندسة	تحسب هذه الدالة الهيكل الخارجي المحدّب للشكل الهندسي.
maxError	ErrorMargin، القيمة التلقائية: null	الحدّ الأقصى لمقدار الخطأ المسموح به عند إجراء أي عملية إعادة إسقاط ضرورية.
proj	التوقّع، القيمة التلقائية: null	الإسقاط الذي سيتم تنفيذ العملية فيه في حال عدم تحديد ذلك، سيتم تنفيذ العملية في نظام إحداثيات كروي، وستكون المسافات الخطية بالأمتار على الكرة الأرضية.

أمثلة

محرّر الرموز البرمجية (JavaScript)

// Define a Polygon object.
var polygon = ee.Geometry.Polygon(
    [[[-122.092, 37.424],
      [-122.086, 37.418],
      [-122.079, 37.425],
      [-122.085, 37.423]]]);

// Apply the convexHull method to the Polygon object.
var polygonConvexHull = polygon.convexHull({'maxError': 1});

// Print the result to the console.
print('polygon.convexHull(...) =', polygonConvexHull);

// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(polygon,
             {'color': 'black'},
             'Geometry [black]: polygon');
Map.addLayer(polygonConvexHull,
             {'color': 'red'},
             'Result [red]: polygon.convexHull');

إعداد Python

راجِع صفحة بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python واستخدام geemap للتطوير التفاعلي.

import ee
import geemap.core as geemap

Colab (Python)

# Define a Polygon object.
polygon = ee.Geometry.Polygon([[
    [-122.092, 37.424],
    [-122.086, 37.418],
    [-122.079, 37.425],
    [-122.085, 37.423],
]])

# Apply the convexHull method to the Polygon object.
polygon_convex_hull = polygon.convexHull(maxError=1)

# Print the result.
display('polygon.convexHull(...) =', polygon_convex_hull)

# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(polygon, {'color': 'black'}, 'Geometry [black]: polygon')
m.add_layer(
    polygon_convex_hull, {'color': 'red'}, 'Result [red]: polygon.convexHull'
)
m