适用于: Databricks Runtime 17.1 及更高版本
重要
此功能目前以公共预览版提供。
如果第一个 GEOMETRY
在第二个 GEOMETRY
内部,则返回 true。
语法
st_within ( geo1, geo2 )
论据
-
geo1
:第一个GEOMETRY
值。 -
geo2
:第二个GEOMETRY
值。
退货
类型为 BOOLEAN
的值;如果第一个几何图形位于第二个几何图形中,则值为 true。
如果任何输入为NULL
,该函数将返回NULL
。
错误条件
- 如果任一输入几何图形是几何图形集合,函数将返回 ST_INVALID_ARGUMENT_TYPE。
- 如果输入几何图形没有相同的 SRID 值,函数将返回 ST_DIFFERENT_SRID_VALUES。
例子
-- 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