ST_DWithin
上一個  11.17. 網格與網格波段空間關係  下一個

名稱

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