ST_CoveredBy

如果Geometry对象或Geography对象A没有任何坐标点在Geometry对象或Geography对象B之外,则返回True。

语法

boolean ST_CoveredBy(geometry geomA , geometry geomB);
boolean ST_CoveredBy(geography geogA , geography geogB);

参数

参数名称

描述

geomA

第一个Geometry对象。

geomB

第二个Geometry对象。

geogA

第一个Geography对象。

geogB

第二个Geography对象。

描述

  • 该函数不支持GeometryCollection类型对象作为输入参数。

  • 不要将该函数用于无效的Geometry对象,否则会得到不可预料的结果。

  • 该函数会自动生成一个bounding box用于利用Geometry对象上的索引。如果不想使用索引,请使用函数_ST_CoveredBy。

示例

SELECT ST_Covers(g1,g2), ST_CoveredBy(g2,g1) 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_coveredby
-----------+--------------
 t         | t
(1 row)