ST_Angle

ST_Angle restituisce l'angolo in radianti tra i punti misurati in senso orario.

• Se vengono inseriti tre punti, l'angolo restituito P1-P2-P3 viene misurato come se fosse ottenuto ruotando da P1 a P3 attorno a P2 in senso orario.

• Se vengono inseriti quattro punti, viene restituito l'angolo restituito in senso orario formato dalle linee dirette P1-P2 e P3-P4. Se l'input è un caso degenerato (ovvero, P1 è uguale a P2 o P3 uguale a P4), viene restituito null.

Il valore di restituzione è in radianti ed è compreso nell'intervallo [0, 2π).

ST_Angle opera sulle proiezioni 2D delle geometrie di input.

Sintassi

ST_Angle(geom1, geom2, geom3)

ST_Angle(geom1, geom2, geom3, geom4)

Argomenti

geom1

Un valore di tipo GEOMETRY o un'espressione che restituisce un valore di tipo GEOMETRY. Questo sottotipo deve essere POINT.

geom2

Un valore di tipo GEOMETRY o un'espressione che restituisce un valore di tipo GEOMETRY. Questo sottotipo deve essere POINT.

geom3

Un valore di tipo GEOMETRY o un'espressione che restituisce un valore di tipo GEOMETRY. Questo sottotipo deve essere POINT.

geom4

Un valore di tipo GEOMETRY o un'espressione che restituisce un valore di tipo GEOMETRY. Questo sottotipo deve essere POINT.

Tipo restituito

DOUBLE PRECISION.

Se geom1 è uguale a geom2 o geom2 è uguale a geom3, allora viene restituito un valore null.

Se geom1, geom2, geom3 o geom4 è null, allora viene restituito un valore null.

Se uno di geom1, geom2, geom3 o geom4 è il punto vuoto, allora viene restituito un errore.

Se geom1, geom2, geom3 e geom4 non hanno lo stesso valore di identificatore del sistema di riferimento spaziale (SRID), allora viene restituito un errore.

Esempi

Il seguente SQL restituisce l'angolo convertito in gradi di tre punti di input.

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

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

Il seguente SQL restituisce l'angolo convertito in gradi di quattro punti di input.

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