إشعار: يجب
إثبات الأهلية للاستخدام غير التجاري لجميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إليها. إذا لم يتم تأكيد حسابك بحلول 26 سبتمبر 2025، قد يتم تعليق إمكانية الوصول إليه.
ee.Geometry.Point.distance
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض هذه الدالة الحد الأدنى للمسافة بين شكلَين هندسيَّين.
| الاستخدام | المرتجعات |
|---|
Point.distance(right, maxError, proj, spherical) | عدد عائم |
| الوسيطة | النوع | التفاصيل |
|---|
هذا: left | هندسة | الشكل الهندسي المستخدَم كمعامل أيسر للعملية |
right | هندسة | الشكل الهندسي المستخدَم كمعامل أيمن للعملية. |
maxError | ErrorMargin، القيمة التلقائية: null | الحدّ الأقصى لمقدار الخطأ المسموح به عند إجراء أي عملية إعادة إسقاط ضرورية. |
proj | التوقّع، القيمة التلقائية: null | الإسقاط الذي سيتم تنفيذ العملية فيه في حال عدم تحديد ذلك، سيتم تنفيذ العملية في نظام إحداثيات كروي، وستكون المسافات الخطية بالأمتار على الكرة الأرضية. |
spherical | قيمة منطقية، القيمة التلقائية: false | إذا كانت القيمة صحيحة، سيتم إجراء عملية الحساب على كرة الوحدة. في حال اختيار القيمة "false"، سيتم إجراء الحساب بشكل بيضوي، مع أخذ تسطّح الأرض في الاعتبار. يتم تجاهله في حال تحديد proj. القيمة التلقائية هي "خطأ". |
أمثلة
محرّر الرموز البرمجية (JavaScript)
// Define a Point object.
var point = ee.Geometry.Point(-122.082, 37.42);
// Define other inputs.
var inputGeom = ee.Geometry.Point(-122.090, 37.423);
// Apply the distance method to the Point object.
var pointDistance = point.distance({'right': inputGeom, 'maxError': 1});
// Print the result to the console.
print('point.distance(...) =', pointDistance);
// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(point,
{'color': 'black'},
'Geometry [black]: point');
Map.addLayer(inputGeom,
{'color': 'blue'},
'Parameter [blue]: inputGeom');
إعداد Python
راجِع صفحة
بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python واستخدام
geemap للتطوير التفاعلي.
import ee
import geemap.core as geemap
Colab (Python)
# Define a Point object.
point = ee.Geometry.Point(-122.082, 37.42)
# Define other inputs.
input_geom = ee.Geometry.Point(-122.090, 37.423)
# Apply the distance method to the Point object.
point_distance = point.distance(right=input_geom, maxError=1)
# Print the result.
display('point.distance(...) =', point_distance)
# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(point, {'color': 'black'}, 'Geometry [black]: point')
m.add_layer(input_geom, {'color': 'blue'}, 'Parameter [blue]: input_geom')
m
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-09-10 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-09-10 (حسب التوقيت العالمي المتفَّق عليه)"],[],["The `distance` method calculates the minimum distance between two geometries (`left` and `right`). It accepts optional parameters: `maxError` (maximum tolerated error), `proj` (projection for calculation), and `spherical` (specifies spherical or elliptical calculation when `proj` is not given). The method returns a float value representing the calculated distance. The example code demonstrates how to define a `Point`, calculate the distance to another geometry, and visualize both elements on a map.\n"]]