本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
ST_Within
ST_Within 會在第一個輸入幾何的 2D 投影位於第二個輸入幾何的 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 會檢查第一個多邊形是否位於第二個多邊形中。
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