如果給定的Geometry對象A完全在對象B之內，則返回True。

語法

boolean  ST_Within(geometry  A , geometry  B);

參數

參數名稱 描述
A 第一個Geometry對象。
B 第二個Geometry對象。

描述

  • 為使此函數有意義，兩個Geometry對象必須都具有相同的投影方式，且具有相同的空間參考（SRID）。
  • 如果ST_Within(A,B)為True且ST_Within(B,A)為True，則認為這兩個Geometry對象在空間上相等。
  • 該函數不支持GeometryCollection類型對象作為輸入參數。
  • 不能將該函數用于無效的Geometry對象，否則將得到錯誤的輸出結果。
  • 該函數會自動生成一個bounding box，用于使用幾何對象上的索引。如果不想使用索引，請使用函數_ST_Within。

示例

SELECT ST_Within('POLYGON((1 1,1 2,2 2,2 1,1 1))'::geometry,'POLYGON((0 0,0 3,3 3,3 0,0 0))'::geometry);
 st_within
-----------
 t
(1 row)