st_within 函数

适用于:已勾选“是”的 Databricks Runtime 17.1 及更高版本

重要

此功能目前以公共预览版提供。

如果第一个 GEOMETRY 在第二个 GEOMETRY 内部,则返回 true。

语法

st_within ( geo1, geo2 )

论据

  • geo1:第一个 GEOMETRY 值。
  • geo2:第二个 GEOMETRY 值。

退货

类型为 BOOLEAN 的值;如果第一个几何图形位于第二个几何图形中,则值为 true。

如果任何输入为NULL,该函数将返回NULL

错误条件

例子

-- Returns true when point is within polygon.
> SELECT st_within(st_geomfromtext('POINT(1 1)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
  true
-- Returns false when point is on boundary.
> SELECT st_within(st_geomfromtext('POINT(5 0)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
  false
-- Returns false when point is outside polygon.
> SELECT st_within(st_geomfromtext('POINT(5 6)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
  false