ST_DWithin

ST_DWithin は、2 つの入力ジオメトリの 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 は、2 つのポリゴン間の距離が 5 ユニットいないであるかどうかを確認します。

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