ST_Within
ST_Within は、最初の入力ジオメトリの 2D 射影が 2 番目の入力ジオメトリの 2D 射影内にある場合、true を返します。
たとえば、A
のすべてのポイントが B
のポイントであり、内部の交差が空でない場合にジオメトリ A
はジオメトリ B
内にあります。
ST_Within(A
、B
) は ST_Contains(B
、A
) と等しいものです。
構文
ST_Within(geom1, geom2)
引数
- geom1
-
データ型
GEOMETRY
の値またはGEOMETRY
型と評価される式の値。この値を geom2 と比較して、geom2 内にあるかどうかを判断します。 - geom2
-
データ型
GEOMETRY
の値またはGEOMETRY
型と評価される式の値。
戻り型
BOOLEAN
geom1 または geom2 が null の場合、null が返されます。
geom1 および geom2 の空間リファレンスシステム識別子 (SRID) 値が同じでない場合、エラーが返されます。
geom1 または geom2 がジオメトリコレクションである場合、エラーが返されます。
例
次の SQL は、最初のポリゴンが 2 番目のポリゴン内にあるかどうかを確認します。
SELECT ST_Within(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'));
st_within
-----------
true