如果给定的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)