ee.FeatureCollection.distance

تُنتج هذه الدالة صورة DOUBLE حيث تكون قيمة كل بكسل هي المسافة بالأمتار من مركز البكسل إلى أقرب نقطة أو خط أو حدود مضلّعة في المجموعة.

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

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

الاستخدامالمرتجعات
FeatureCollection.distance(searchRadius, maxError)صورة
الوسيطةالنوعالتفاصيل
هذا: featuresFeatureCollectionمجموعة العناصر التي سيتم الحصول منها على العناصر المستخدَمة لاحتساب مسافات البكسل
searchRadiusFloat، القيمة التلقائية: 100000الحد الأقصى للمسافة بالأمتار من كل بكسل للبحث عن الحواف سيتم إخفاء وحدات البكسل ما لم تكن هناك حواف ضمن هذه المسافة.
maxErrorالنوع: عدد عشري، القيمة التلقائية: 100الحدّ الأقصى لخطأ إعادة العرض بالكيلومترات، ويتم استخدامه فقط إذا كانت الخطوط المتعددة للإدخال تتطلّب إعادة العرض. في حال توفير القيمة 0، ستفشل هذه العملية إذا كان الإسقاط مطلوبًا.

أمثلة

أداة تعديل الرموز (JavaScript)

// FeatureCollection of power plants in Belgium.
var fc = ee.FeatureCollection('WRI/GPPD/power_plants')
             .filter('country_lg == "Belgium"');

// Generate an image of distance to nearest power plant.
var distance = fc.distance({searchRadius: 50000, maxError: 50});

// Display the image and FeatureCollection on the map.
Map.setCenter(4.56, 50.78, 7);
Map.addLayer(distance, {max: 50000}, 'Distance to power plants');
Map.addLayer(fc, {color: 'red'}, 'Power plants');

إعداد Python

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

import ee
import geemap.core as geemap

Colab (Python)

# FeatureCollection of power plants in Belgium.
fc = ee.FeatureCollection('WRI/GPPD/power_plants').filter(
    'country_lg == "Belgium"'
)

# Generate an image of distance to nearest power plant.
distance = fc.distance(searchRadius=50000, maxError=50)

# Display the image and FeatureCollection on the map.
m = geemap.Map()
m.set_center(4.56, 50.78, 7)
m.add_layer(distance, {'max': 50000}, 'Distance to power plants')
m.add_layer(fc, {'color': 'red'}, 'Power plants')
m