适用于: Databricks Runtime 17.1 及更高版本
重要
此功能目前以公共预览版提供。
返回输入 GEOGRAPHY
或 GEOMETRY
值的长度。
语法
st_length ( geoExpr )
论据
-
geoExpr
:GEOGRAPHY
或GEOMETRY
值。
退货
类型的 DOUBLE
值,表示输入 GEOGRAPHY
或 GEOMETRY
值的长度。
如果输入是一个 GEOGRAPHY
值,该函数将返回值的线性部分 GEOGRAPHY
的 2D 测地长度。
具体而言,该函数返回线字符串的地理长度,以及多行字符串中线字符串长度的总和。
对于非线性地理图形(点、多边形、多点和多多边形),返回0;而对于几何图形集合,函数则返回集合中所有元素长度的总和。
通过执行假设 WGS84 椭圆的逆地理计算来计算结果。
结果单位为计量。
如果输入是一个 GEOMETRY
值,则函数返回值的线性部分 GEOMETRY
的 2D 笛卡尔长度。
具体而言,该函数返回线字符串的 2D 笛卡尔长度,以及多行字符串中线字符串长度的总和。
对于非线性几何形状(点、多边形、多点和多多边形),将返回0,而对于几何图形集合,则返回集合中元素长度的总和。
结果的单位与输入值GEOMETRY
的空间参考系统的单位相同。
如果任何输入为NULL
,该函数将返回NULL
。
例子
-- Returns the length of a 2D Cartesian linestring.
> SELECT round(st_length(st_geomfromtext('LINESTRING(10 34,44 57,30 24)')), 8);
76.89564816