Partager via

st_transform Fonction

S’applique à :check marqué oui Databricks SQL vérifié marqué oui Databricks Runtime 17.1 et versions ultérieures

Important

Cette fonctionnalité est disponible en préversion publique.

Note

Cette fonctionnalité n’est pas disponible sur les entrepôts Databricks SQL Classic. Pour en savoir plus sur les entrepôts SQL Databricks, consultez les types d’entrepôts SQL.

Transforme les coordonnées X et Y de la géométrie d’entrée depuis le système de référence de coordonnées (CRS) actuel vers le système de référence de coordonnées décrit par la valeur SRID fournie.

Syntax

st_transform ( geo, srid )

Arguments

  • geo: une valeur de GEOMETRY.
  • srid: valeur SRID du nouveau système de référence de coordonnées (CRS) vers lequel la géométrie d’entrée doit être transformée.

Returns

Valeur de type GEOMETRY, représentant la géométrie transformée.

Si la géométrie comporte des coordonnées Z et M, elles seront présentes dans la géométrie de sortie et ne seront pas modifiées.

Le SRID de la sortie GEOMETRY est égal à la valeur SRID d’entrée.

La fonction retourne NULL si l’une des entrées est NULL.

Conditions d'erreur

  • S’il n’est pas possible de passer du CRS de la géométrie d’entrée au CRS décrit par la valeur SRID fournie, la fonction retourne 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
  • Last updated on