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
aPointdoit être une géométrie de type point. La transmission de tout autre type de géométrie renvoieNULL.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)