ST_DWithin - Amazon Redshift

Amazon Redshift 自 2025 年 11 月 1 日起不再支援建立新的 Python UDF。如果您想要使用 Python UDF,請在該日期之前建立 UDF。現有 Python UDF 將繼續正常運作。如需詳細資訊,請參閱部落格文章

ST_DWithin

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

語法

ST_DWithin(geom1, geom2, threshold)

引數

geom1

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

geom2

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

threshold

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

傳回類型

BOOLEAN

如果 geom1geom2 為 Null,則會傳回 Null。

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

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

如果 geom1geom2 是幾何集合,則會傳回錯誤。

範例

以下 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