Tous les produits
Search
Centre de documentation

ApsaraDB RDS:ST_Z

Dernière mise à jour :Sep 02, 2026

Renvoie la coordonnée Z d'une géométrie de type point sous forme de nombre à virgule flottante.

Syntaxe

float ST_Z(geometry aPoint);

Paramètres

Paramètre Description
aPoint Géométrie de type point dont il faut extraire la coordonnée Z.

Valeur renvoyée

Renvoie la coordonnée Z sous forme de float.

Renvoie NULL si l'entrée est NULL ou ne correspond pas à une géométrie de type point valide.

Notes d'utilisation

  • Le paramètre aPoint doit être une géométrie de type point. La transmission de tout autre type de géométrie renvoie NULL.

  • La fonction ST_Z conserve les coordonnées Z et ne les supprime pas des géométries 3D.

Exemples

Extraire la coordonnée Z d'un point 4D

SELECT ST_Z('POINT(0 1 2 3)'::geometry);

Résultat :

 st_z
------
    2
(1 row)

Le point d'entrée possède les coordonnées x=0, y=1, z=2, m=3. La fonction ST_Z renvoie 2, soit la coordonnée Z.

Comportement avec une entrée NULL ou non ponctuelle

La fonction ST_Z renvoie NULL pour une entrée NULL ainsi que pour les types de géométrie autres que les points :

SELECT
    ST_Z(NULL),
    ST_Z('LINESTRING(0 0 1, 1 1 2)'::geometry);

Résultat :

 st_z | st_z
------+------
 NULL | NULL
(1 row)

Voir aussi

  • ST_X — renvoie la coordonnée X d'un point

  • ST_Y — renvoie la coordonnée Y d'un point