名称

ST_DWithin — 如果栅格 rastA 和 rastB 在指定距离内,则返回 true。

语法

boolean ST_DWithin( raster rastA , integer nbandA , raster rastB , integer nbandB , double precision distance_of_srid );

boolean ST_DWithin( raster rastA , raster rastB , double precision distance_of_srid );

描述

如果栅格 rastA 和 rastB 在指定距离内,则返回 true。如果未提供波段号(或将其设置为 NULL),则在测试中仅考虑栅格的凸包。如果提供了波段号,则仅在测试中考虑具有值(非 NODATA)的那些像素。

距离以栅格的空间参考系统定义的单位指定。为了使此函数有意义,源栅格必须具有相同的坐标投影,具有相同的 SRID。

[Note]

此操作数将使用栅格上可能存在的任何索引。

[Note]

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

可用性:2.1.0

示例

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

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

另请参阅

ST_Within, ST_DFullyWithin