名称

ST_CoveredBy — 如果光栅 rastA 的任何点都不位于光栅 rastB 外部,则返回 true。

语法

boolean ST_CoveredBy( raster rastA , integer nbandA , raster rastB , integer nbandB );

boolean ST_CoveredBy( raster rastA , raster rastB );

说明

只有当 rastA 的任何点都不位于 rastB 的外部时,光栅 rastA 才被 rastB 覆盖。如果未提供波段编号(或将其设置为 NULL),则测试中仅考虑光栅的凸包。如果提供了波段编号,则测试中仅考虑那些具有值(非 NODATA)的像素。

[Note]

此函数将使用光栅上可能存在的任何索引。

[Note]

要测试光栅和几何的空间关系,请对光栅使用 ST_Polygon,例如 ST_CoveredBy(ST_Polygon(raster), geometry) 或 ST_CoveredBy(geometry, ST_Polygon(raster))。

可用性:2.1.0

示例

SELECT r1.rid, r2.rid, ST_CoveredBy(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;

 rid | rid | st_coveredby
-----+-----+--------------
   2 |   1 | f
   2 |   2 | t
            

另请参阅

ST_IntersectsST_Covers