ST_Angle

ST_Angle renvoie l’angle en radians entre les points mesurés dans le sens des aiguilles d’une montre comme suit :

• Si trois points sont entrés, l’angle P1-P2-P3 renvoyé est mesuré comme si l’angle était obtenu en tournant de P1 à P3 autour de P2 dans le sens des aiguilles d’une montre.

• Si quatre points sont entrés, l’angle dans le sens des aiguilles d’une montre renvoyé et formé par les lignes orientées P1-P2 et P3-P4 est renvoyé. Si l’entrée est un cas dégénéré (c’est-à-dire que P1 est égal à P2 ou que P3 égal à P4), la valeur null est renvoyée.

La valeur de renvoi est en radians et dans la plage [0, 2π).

ST_Angle fonctionne sur des projections 2D des géométries en entrée.

Syntaxe

ST_Angle(geom1, geom2, geom3)

ST_Angle(geom1, geom2, geom3, geom4)

Arguments

geom1

Valeur de type de données GEOMETRY ou expression qui est évaluée sur un type GEOMETRY. Le sous-type doit être POINT.

geom2

Valeur de type de données GEOMETRY ou expression qui est évaluée sur un type GEOMETRY. Le sous-type doit être POINT.

geom3

Valeur de type de données GEOMETRY ou expression qui est évaluée sur un type GEOMETRY. Le sous-type doit être POINT.

geom4

Valeur de type de données GEOMETRY ou expression qui est évaluée sur un type GEOMETRY. Le sous-type doit être POINT.

Type de retour

DOUBLE PRECISION.

Si geom1 est égal à geom2 ou geom2 est égal à geom3, alors une valeur null est renvoyée.

Si geom1, geom2, geom3, ou geom4 est null, alors une valeur null est renvoyée.

Si geom1, geom2, geom3 ou geom4 est le point vide, une erreur est renvoyée.

Si geom1, geom2, geom3 et geom4 n’ont pas la même valeur pour l’identifiant de système de référence spatiale (SRID), une erreur est renvoyée.

Exemples

Le SQL suivant renvoie l’angle converti en degrés de trois points d’entrée.

SELECT ST_Angle(ST_Point(1,1), ST_Point(0,0), ST_Point(1,0)) / Pi() * 180.0 AS angle;

 angle
---------------
    45              

Le SQL suivant renvoie l’angle converti en degrés de quatre points d’entrée.

SELECT ST_Angle(ST_Point(1,1), ST_Point(0,0), ST_Point(1,0), ST_Point(2,0)) / Pi() * 180.0 AS angle;

 angle
---------------
   225