如果Geometry對象或Geography對象B沒有任何坐標點在對象A之外，則返回True。

語法

boolean  ST_Covers(geometry  geomA , geometry  geomB);
boolean  ST_Covers(geography  geogpolyA , geography  geogpointB);

參數

參數名稱 描述
geomA 第一個Geometry對象。
geomB 第二個Geometry對象。
geogpolyA 第一個Geography對象。
geogpointB 第二個Geography對象。

描述

  • 該函數不支持GeometryCollection類型對象作為輸入參數。
  • 不要將該函數用于無效的Geometry對象，否則會得到不可預料的結果。
  • 該函數會自動生成一個bounding box用于利用Geometry對象上的索引。如果不想使用索引，請使用函數ST_Covers。

示例

ST_Covers與ST_Contains的區別：
SELECT ST_Covers(g1,g2), ST_Contains(g1,g2) FROM (SELECT 'POLYGON((0 0,1 1,1 0,0 0))'::geometry as g1,
                                                               'LINESTRING(0 0,1 1)'::geometry as g2) as test;
 st_covers | st_contains
-----------+-------------
 t         | f
(1 row)