适用于: Databricks Runtime 17.1 及更高版本
Important
此功能目前以公共预览版提供。
将输入几何图形的 X 和 Y 坐标从当前坐标引用系统(CRS)转换为所提供的 SRID 值描述的坐标引用系统。
Syntax
st_transform ( geo, srid )
Arguments
-
geo
:一个GEOMETRY
值。 -
srid
:应将输入几何图形转换为的新坐标参考系统 (CRS) 的 SRID 值。
Returns
类型的 GEOMETRY
值,表示转换后的几何图形。
如果几何图形具有 Z 和 M 坐标,它们将存在于输出几何图形中,并且不会修改。
输出 GEOMETRY
的 SRID 等于输入 SRID 值。
如果任何输入为NULL
,该函数将返回NULL
。
Error conditions
- 如果输入 SRID 值为非正值,则函数返回 ST_INVALID_ARGUMENT。
- 如果无法从输入几何图形的 CRS 转换为提供的 SRID 值描述的 CRS,函数将返回 ST_INVALID_ARGUMENT。
Examples
-- Transforms coordinates from WGS84 to Web Mercator.
> SELECT st_astext(st_transform(st_geomfromtext('MULTIPOINT Z (4 5 14,-3 8 27,EMPTY)', 4326), 3857))
MULTIPOINT Z ((445277.96317309426 557305.2572745768 14),(-333958.4723798207 893463.751012646 27),EMPTY)
-- Returns geometry in new coordinate system.
> SELECT st_srid(st_transform(st_geomfromtext('POINT(0 0)', 4326), 3857))
3857