ee.Geometry.Polygon

تنشئ هذه الدالة عنصر ee.Geometry يصف مضلّعًا.

لتسهيل الأمر، يمكن استخدام الوسيط المتغيّر عندما تكون جميع الوسيطات أرقامًا. يتيح ذلك إنشاء مضلّعات جيوديسية EPSG:4326 باستخدام LinearRing واحد مع عدد زوجي من الوسيطات، مثل ee.Geometry.Polygon(aLng, aLat, bLng, bLat, ..., aLng, aLat).

الاستخدام	المرتجعات
ee.Geometry.Polygon(coords, proj, geodesic, maxError, evenOdd)	Geometry.Polygon

الوسيطة	النوع	التفاصيل
coords	List<Geometry>|List<List<List<Number>>>|List<Number>	قائمة بالحلقات التي تحدّد حدود المضلّع. يمكن أن تكون قائمة إحداثيات بتنسيق GeoJSON "مضلّع" أو قائمة عناصر ee.Geometry تصف LinearRing أو قائمة أرقام تحدّد حدود مضلّع واحد.
proj	التوقّعات، اختيارية	إسقاط هذا الشكل الهندسي القيمة التلقائية هي إسقاط المدخلات، حيث يُفترض أنّ الأرقام هي EPSG:4326.
geodesic	قيمة منطقية، اختيارية	إذا كانت القيمة false، تكون الحواف مستقيمة في العرض. إذا كانت القيمة هي true، تكون الحواف منحنية لتتّبع أقصر مسار على سطح الأرض. القيمة التلقائية هي الحالة الجيوديسية للمدخلات، أو "صحيح" إذا كانت المدخلات أرقامًا.
maxError	ErrorMargin، اختياري	الحدّ الأقصى للخطأ عندما يجب إعادة عرض الشكل الهندسي للإدخال إلى عرض النتائج المطلوب بشكل صريح أو حالة خطوط الطول والعرض
evenOdd	قيمة منطقية، اختيارية	إذا كانت القيمة صحيحة، سيتم تحديد الأجزاء الداخلية للمضلّع حسب قاعدة الزوجي/الفردي، حيث تكون النقطة داخل المضلّع إذا كانت تعبر عددًا فرديًا من الحواف للوصول إلى نقطة في اللانهاية. وفي الحالات الأخرى، تستخدم المضلّعات قاعدة "اليسار-الداخل"، حيث تكون الأجزاء الداخلية على الجانب الأيسر من حواف الشكل عند التنقّل بين الرؤوس بالترتيب المحدّد. إذا لم يتم تحديد هذه السمة، تكون القيمة التلقائية هي "صحيح".

أمثلة

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

// Construct a polygon from a list of GeoJSON 'Polygon' formatted coordinates.
var polygonGeoJSON = ee.Geometry.Polygon(
  [
    [ // exterior ring
      [100.0, 0.0],
      [103.0, 0.0],
      [103.0, 3.0],
      [100.0, 3.0],
      [100.0, 0.0]  // matching the first vertex is optional
    ],
    [ // interior ring
      [101.0, 1.0],
      [102.0, 2.0],
      [102.0, 1.0]
    ]
  ]
);
Map.addLayer(polygonGeoJSON, {}, 'polygonGeoJSON');

// Construct a polygon from an ee.Geometry.LinearRing.
var polygonLinearRing = ee.Geometry.Polygon(
  [
    ee.Geometry.LinearRing(
      [
        [105.0, 0.0],
        [108.0, 0.0],
        [108.0, 3.0]
      ]
    )
  ]
);
Map.addLayer(polygonLinearRing, {}, 'polygonLinearRing');

// Construct a polygon from a list of x,y coordinate pairs defining a boundary.
var polygonCoordList = ee.Geometry.Polygon(
  [110.0, 0.0, 113.0, 0.0, 110.0, 3.0]
);
Map.addLayer(polygonCoordList, {}, 'polygonCoordList');

Map.centerObject(polygonLinearRing);