ST_CoveredBy

الوصف

تُعيد true إذا وقعت كل نقطة في Geometry/Geography ‏A داخل Geometry/Geography ‏B (أي تتقاطع مع داخله أو حدوده). وبصورة مكافئة، تختبر أنه لا توجد نقطة من A تقع خارج B (في خارجه).

بالصيغة الرياضية: ST_CoveredBy(A, B) ⇔ A ⋂ B = A

ST_CoveredBy هي عكس ST_Covers. لذا فإن ST_CoveredBy(A,B) = ST_Covers(B,A).

يُفضَّل عمومًا استخدام هذه الدالة بدلًا من ST_Within، لأن تعريفها أبسط ولا يتضمن الخاصية الغريبة «الحدود لا تقع داخل شكلها الهندسي».

تُنفَّذ بواسطة وحدة GEOS

متاحة منذ: 1.2.2

ملاحظة: هذا هو الإصدار «المسموح به» الذي يُعيد قيمة منطقية (boolean)، وليس عددًا صحيحًا.

ليست معيارًا من OGC، لكنها موجودة في Oracle أيضًا.

أمثلة

--a circle coveredby a circle
SELECT ST_CoveredBy(smallc,smallc) As smallinsmall,
  ST_CoveredBy(smallc, bigc) As smallcoveredbybig,
  ST_CoveredBy(ST_ExteriorRing(bigc), bigc) As exteriorcoveredbybig,
  ST_Within(ST_ExteriorRing(bigc),bigc) As exeriorwithinbig
FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 2)'), 10) As smallc,
  ST_Buffer(ST_GeomFromText('POINT(1 2)'), 20) As bigc) As foo;
  --Result
 smallinsmall | smallcoveredbybig | exteriorcoveredbybig | exeriorwithinbig
--------------+-------------------+----------------------+------------------
 t            | t                 | t                    | f
(1 row) 

انظر أيضًا

ST_Contains, ST_Covers, ST_ExteriorRing, ST_Within