ST_CoveredBy
如果第一个输入几何体的 2D 投影被第二个输入几何体的 2D 投影覆盖,则 ST_CoveredBy 返回 true。如果几何体 A
和几何体 B
都是非空的,并且 A
中的每个点均为 B
中的一个点,则前者被后者覆盖。
ST_CoveredBy(A
, B
) 与 ST_Covers(B
, A
) 等效。
语法
ST_CoveredBy(geom1, geom2)
参数
- geom1
-
一个
GEOMETRY
数据类型的值,或一个计算结果为GEOMETRY
类型的表达式。此值将与 geom2 进行比较以确定它是否被 geom2 覆盖。 - geom2
-
一个
GEOMETRY
数据类型的值,或一个计算结果为GEOMETRY
类型的表达式。
返回类型
BOOLEAN
如果 geom1 或 geom2 为 null,则返回 null。
如果 geom1 和 geom2 不具有相同的空间参考系统标识符 (SRID) 值,则返回一个错误。
如果 geom1 或 geom2 为几何体集合,则返回一个错误。
示例
以下 SQL 检查第一个多边形是否被第二个多边形覆盖。
SELECT ST_CoveredBy(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'));
st_coveredby
-----------
true