Функция st_transform

Применяется к: Databricks SQL Databricks Runtime 17.1 и более поздних версий

Замечание

Эта функция недоступна в классических хранилищах Databricks SQL. Дополнительные сведения о хранилищах SQL Databricks см. в разделе "Типы хранилища SQL".

Преобразует координаты X и Y входной геометрии из текущей системы координат (CRS) в систему координат, описанную указанным значением SRID.

Syntax

st_transform ( geo, srid )

Arguments

• geo: GEOMETRY значение.
• srid: значение SRID новой эталонной системы координат (CRS), в которую необходимо преобразовать входную геометрию.

Returns

Значение типа GEOMETRY, представляющее преобразованную геометрию.

Если геометрия имеет координаты Z и M, они будут присутствовать в выходной геометрии и не будут изменены.

SRID выходных данных GEOMETRY равен входному значению SRID.

Функция возвращает NULL, если какие-либо из входных данных NULL.

Условия ошибок

• Если невозможно преобразовать из CRS входной геометрии в CRS, описанную указанным значением SRID, функция возвращает ST_INVALID_CRS_TRANSFORMATION_ERROR.

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

-- When invoking st_transform with a literal for the SRID value, the output geometry type inherits the SRID value.
> SELECT typeof(st_transform(st_geomfromtext('POINT(0 0)', 4326), 4267));
  geometry(4267)

Связанные функции

• st_setsrid функция
• st_srid функция