st_transform Funkce

Platí pro: Kontrola SQL Databricks Databricks Runtime 17.1 a vyšší

Poznámka:

Tato funkce není k dispozici ve skladech Databricks SQL Classic. Další informace o službě Databricks SQL Warehouse najdete v tématu Typy SQL Warehouse.

Transformuje souřadnice X a Y vstupní geometrie z aktuálního referenčního systému souřadnic (CRS) na souřadnicový referenční systém popsaný zadanou hodnotou SRID.

Syntax

st_transform ( geo, srid )

Arguments

• geo: Hodnota GEOMETRY.
• srid: Hodnota SRID nového referenčního systému souřadnic (CRS), na který má být vstupní geometrie transformována.

Returns

Hodnota typu GEOMETRYpředstavující transformovanou geometrii.

Pokud geometrie obsahuje souřadnice Z a M, budou přítomny ve výstupní geometrii a nebudou změněny.

SRID výstupu GEOMETRY se rovná vstupní hodnotě SRID.

Funkce vrátí NULL , pokud je některý ze vstupů NULL.

Chybové podmínky

• Pokud není možné transformovat ze vstupní geometrie CRS na CRS popsanou zadanou hodnotou SRID, vrátí funkce 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)

Související funkce

• st_setsrid funkce
• st_srid funkce