Delen via

st_transform functie

Van toepassing op:controleren gemarkeerd ja Databricks SQL-controle gemarkeerd als ja Databricks Runtime 17.1 en hoger

Important

Deze functie bevindt zich in openbare preview-versie.

Opmerking

Deze functie is niet beschikbaar in Databricks SQL Classic Warehouses. Zie SQL Warehouse-typen voor meer informatie over Databricks SQL-warehouses.

Transformeert de X- en Y-coördinaten van de invoergeometrie van het huidige coördinaatreferentiesysteem (CRS) naar het coördinaatreferentiesysteem dat wordt beschreven door de opgegeven SRID-waarde.

Syntax

st_transform ( geo, srid )

Arguments

  • geo: Een GEOMETRY waarde.
  • srid: De SRID-waarde van het nieuwe coördinaatreferentiesysteem (CRS) waarop de invoergeometrie moet worden getransformeerd.

Returns

Een waarde van het type GEOMETRY, die de getransformeerde geometrie vertegenwoordigt.

Als de geometrie Z- en M-coördinaten heeft, zijn ze aanwezig in de uitvoergeometrie en worden ze niet gewijzigd.

De SRID van de uitvoer GEOMETRY is gelijk aan de invoer-SRID-waarde.

De functie retourneert NULL als een van de invoerwaarden is NULL.

Foutvoorwaarden

  • Als het niet mogelijk is om te transformeren van de CRS van de invoergeometrie naar de CRS die wordt beschreven door de opgegeven SRID-waarde, retourneert de functie 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)
  • Last updated on