ST_Perimeter

Pour une géométrie surfacique, ST_Perimeter renvoie le périmètre cartésien (longueur de la frontière) de la projection 2D. Les unités de périmètre sont les mêmes que les unités dans lesquelles les coordonnées de la géométrie en entrée sont exprimées. La fonction renvoie zéro (0) pour les points, les multipoints et les géométries linéaires. Lorsque l’entrée est une collection de géométries, la fonction renvoie la somme des périmètres des géométries de la collection.

Pour une géographie d’entrée, ST_Perimeter renvoie le périmètre géodésique (longueur de la limite) de la projection 2D d’une géographie surfacique d’entrée calculée sur le sphéroïde déterminé par le SRID. L’unité de périmètre est exprimée en mètres. La fonction renvoie zéro (0) pour les points, les multipoints et les géomgraphies linéaires. Lorsque l’entrée est une collection de géométries, la fonction renvoie la somme des périmètres des géographies de la collection.

Syntaxe

ST_Perimeter(geo)

Arguments

geo

Valeur de type de données GEOMETRY ou GEOGRAPHY ou expression qui est évaluée sur un type GEOMETRY ou GEOGRAPHY.

Type de retour

DOUBLE PRECISION

Si geo est null, null est renvoyé.

Si la valeur SRID est introuvable, une erreur est renvoyée.

Exemples

Le SQL suivant renvoie le périmètre cartésien d’un multipolygone.

SELECT ST_Perimeter(ST_GeomFromText('MULTIPOLYGON(((0 0,10 0,0 10,0 0)),((10 0,20 0,20 10,10 0)))'));

 st_perimeter
--------------------------------
    68.2842712474619   

Le SQL suivant renvoie le périmètre cartésien d’un multipolygone.

SELECT ST_Perimeter(ST_GeomFromText('MULTIPOLYGON(((0 0,10 0,0 10,0 0)),((10 0,20 0,20 10,10 0)))'));

 st_perimeter
--------------------------------
    68.2842712474619   

Le code SQL suivant renvoie le périmètre d’un polygone dans une géographie.

SELECT ST_Perimeter(ST_GeogFromText('SRID=4326;POLYGON((0 0,1 0,0 1,0 0))'));

 st_perimeter 
------------------
 378790.428393693 

Le code SQL suivant renvoie le périmètre d’une linestring dans une géographie.

SELECT ST_Perimeter(ST_GeogFromText('SRID=4326;LINESTRING(5 0,10 0)'));

 st_perimeter 
--------------
 0