ee.Geometry.closestPoint

تعرض هذه الدالة النقطة في الإدخال الأيمن الأقرب إلى الإدخال الأيسر. إذا كان أي من الإدخالَين فارغًا، يتم عرض قيمة فارغة. إذا كان كلا الإدخالين غير محدودَين، يتم عرض نقطة عشوائية. إذا كان أحد الإدخالَين غير محدود، يتم عرض نقطة عشوائية في الإدخال المحدود.

الاستخدام	المرتجعات
Geometry.closestPoint(right, maxError, proj)	عنصر

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

أمثلة

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

// Define a Geometry object.
var geometry = ee.Geometry({
  'type': 'Polygon',
  'coordinates':
    [[[-122.081, 37.417],
      [-122.086, 37.421],
      [-122.084, 37.418],
      [-122.089, 37.416]]]
});

// Define other inputs.
var inputGeom = ee.Geometry.Polygon(
        [[[-122.068, 37.418],
          [-122.068, 37.416],
          [-122.064, 37.416],
          [-122.064, 37.418]]]);

// Apply the closestPoints method to the Geometry objects.
var closestPoints = ee.Dictionary(geometry.closestPoints({'right': inputGeom, 'maxError': 1}));

// Print the result to the console.
print('geometry.closestPoints(...) =', closestPoints);

// There is also a one-sided API for convenience.
var closestPointOnInputGeom = geometry.closestPoint({'right': inputGeom, 'maxError': 1});
print('geometry.closestPoint(...) =', closestPointOnInputGeom);

// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(geometry,
             {'color': 'black'},
             'Geometry [black]: geometry');
Map.addLayer(inputGeom,
             {'color': 'blue'},
             'Parameter [blue]: inputGeom');
Map.addLayer(closestPoints.getGeometry('left'),
             {'color': 'red'},
             'Result [red]: closestPointOnLeft');
Map.addLayer(closestPoints.getGeometry('right'),
             {'color': 'red'},
             'Result [red]: closestPointOnRight');