Поделиться через


Функция st_transform

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

Important

Эта функция доступна в общедоступной предварительной версии.

Замечание

Эта функция недоступна в классических хранилищах 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