ST_DWithin

ST_DWithin 會在兩個輸入幾何值的 2D 投影之間的歐幾里得距離不大於閾值時傳回 True。

語法

ST_DWithin(geom1, geom2, threshold)

引數

geom1

GEOMETRY 資料類型的值，或是評估為 GEOMETRY 類型的表達式。

geom2

GEOMETRY 資料類型的值，或是評估為 GEOMETRY 類型的表達式。

threshold

DOUBLE PRECISION 資料類型的值。這個值的單位是輸入引數。

傳回類型

BOOLEAN

如果 geom1 或 geom2 為 Null，則會傳回 Null。

如果 threshold 為負值，則會傳回錯誤。

如果 geom1 和 geom2 的空間參考系統識別碼 (SRID) 不同，則會傳回錯誤。

如果 geom1 或 geom2 是幾何集合，則會傳回錯誤。

範例

以下 SQL 會檢查兩個多邊形間的距離是否在五個單位內。

SELECT ST_DWithin(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'),5);

st_dwithin
-----------
 true