st_transform 函数

适用于:已勾选“是”的 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