适用于: Databricks Runtime 17.1 及更高版本
重要
此功能目前以公共预览版提供。
返回输入 GEOGRAPHY
或 GEOMETRY
值的区域。
语法
st_area ( geoExpr )
论据
-
geoExpr
:GEOGRAPHY
或GEOMETRY
值。
退货
类型的 DOUBLE
值,表示输入 GEOGRAPHY
或 GEOMETRY
值的区域。
如果输入是一个 GEOGRAPHY
值,该函数将返回值的 2D 地理区域 GEOGRAPHY
。
具体而言,该函数返回多边形的地理区域,以及多边形中多边形区域的总和。
对于非面状地理对象(如点、线字符串、多点和多线字符串),函数将返回0。对于几何集合,函数将返回集合中各个元素的面积总和。
通过执行假设 WGS84 椭圆的逆地理计算来计算结果。
结果单位为平方米。
如果输入是一个 GEOMETRY
值,该函数将返回值的 GEOMETRY
2D 笛卡尔区域。
具体而言,该函数返回多边形的 2D 笛卡尔区,以及多边形中多边形区域的总和。
对于非面状几何体(点、线串、多点和多条线串),返回0,而对于几何体集合作为元素区域的总和进行返回。
结果的单位是输入 GEOMETRY
值的空间引用系统的单位(平方)。
如果任何输入为NULL
,该函数将返回NULL
。
例子
-- Returns the area of a 2D Cartesian polygon with a hole.
> SELECT st_area(st_geomfromtext('POLYGON((0 0,50 0,50 50,0 50,0 0),(20 20,25 30,30 20,20 20))'));
2450.0