GISarabia.org
PostGIS › الدليل الرسمي › 7. مرجع PostGIS › 7.11.2. علاقات المسافة
PostGIS 3.6 · Official Manual · ترجمة عربية

ST_DFullyWithin

الصفحة الأصلية بالإنجليزية postgis.net ↗

الاسم

ST_DFullyWithin — تختبر ما إذا كان شكل هندسي يقع بالكامل ضمن مسافة معيّنة من شكل آخر

المختصر

boolean ST_DFullyWithin(geometry g1, geometry g2, double precision distance);

الوصف

تُعيد true إذا كان g2 يقع بالكامل ضمن المسافة distance من g1. بصريًا، يتحقق الشرط إذا كان g2 محتوًى داخل نطاق عازل بمسافة distance حول g1. تُحدَّد المسافة بالوحدات المعرّفة في النظام المرجعي المكاني للأشكال الهندسية.

[ملاحظة]

تتضمن هذه الدالة تلقائيًا مقارنةً للمستطيل المحيط تستفيد من أي فهارس مكانية متاحة على الأشكال الهندسية.

متاحة منذ: 1.5.0

تغيّرت في: 3.5.0: أصبح منطق الدالة يعتمد على اختبار الاحتواء داخل نطاق عازل بدلًا من خوارزمية ST_MaxDistance. ستختلف النتائج عن الإصدارات السابقة، لكنها يُفترض أن تكون أقرب إلى توقعات المستخدم.

أمثلة

SELECT
    ST_DFullyWithin(geom_a, geom_b, 10) AS DFullyWithin10,
    ST_DWithin(geom_a, geom_b, 10) AS DWithin10,
    ST_DFullyWithin(geom_a, geom_b, 20) AS DFullyWithin20
FROM (VALUES
    ('POINT(1 1)', 'LINESTRING(1 5, 2 7, 1 9, 14 12)')
    ) AS v(geom_a, geom_b)

 dfullywithin10 | dwithin10 | dfullywithin20
----------------+-----------+----------------
 f              | t         | t