ee.FeatureCollection.distance

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

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

الاستخدامالمرتجعات
FeatureCollection.distance(searchRadius, maxError)صورة
الوسيطةالنوعالتفاصيل
هذا: featuresFeatureCollectionمجموعة العناصر التي سيتم الحصول منها على العناصر المستخدَمة لاحتساب مسافات البكسل
searchRadiusعدد صحيح، القيمة التلقائية: 100000الحد الأقصى للمسافة بالأمتار من كل بكسل للبحث عن الحواف سيتم إخفاء وحدات البكسل ما لم تكن هناك حواف ضمن هذه المسافة.
maxErrorFloat، القيمة التلقائية: 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