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