ST_Angle

ST_Angle gibt den Winkel im Bogenmaß zwischen Punkten zurück, gemessen im Uhrzeigersinn. Und zwar wie folgt:

• Wenn drei Punkte eingegeben werden, wird der zurückgegebene Winkel P1-P2-P3 so gemessen, als ob der Winkel durch Drehen von P1 nach P3 um P2 im Uhrzeigersinn ermittelt wurde.

• Wenn vier Punkte eingegeben werden, wird der zurückgegebene Winkel im Uhrzeigersinn zurückgegeben, der durch die gerichteten Linien P1-P2 und P3-P4 gebildet wird. Wenn es sich bei der Eingabe um einen fehlerhaften Fall handelt (d. h. P1 entspricht P2 oder P3 entspricht P4), wird null zurückgegeben.

Der Rückgabewert wird in Radianten ausgedrückt und liegt im Bereich (0, 2π).

ST_Boundary wird auf den 2D-Projektionen der Eingabegeometrien ausgeführt.

Syntax

ST_Angle(geom1, geom2, geom3)

ST_Angle(geom1, geom2, geom3, geom4)

Argumente

geom1

Ein Wert vom Datentyp GEOMETRY oder ein Ausdruck, der zu einem GEOMETRY-Typ ausgewertet wird. Der Subtyp muss sein POINT.

geom2

Ein Wert vom Datentyp GEOMETRY oder ein Ausdruck, der zu einem GEOMETRY-Typ ausgewertet wird. Der Subtyp muss sein POINT.

geom3

Ein Wert vom Datentyp GEOMETRY oder ein Ausdruck, der zu einem GEOMETRY-Typ ausgewertet wird. Der Subtyp muss sein POINT.

geom4

Ein Wert vom Datentyp GEOMETRY oder ein Ausdruck, der zu einem GEOMETRY-Typ ausgewertet wird. Der Subtyp muss sein POINT.

Rückgabetyp

DOUBLE PRECISION.

Wenn geom1 geom2, entspricht oder geom2 geom3, entspricht, wird null zurückgegeben.

Wenn geom1, geom2, geom3 oder geom4 null ist, wird null zurückgegeben.

Wenn geom1, geom2, geom3 oder geom4 der leere Punkt ist, wird ein Fehler zurückgegeben.

Wenn geom1, geom2, geom3 und geom4 nicht den gleichen SRID-Wert (Spatial Reference System Identifier) haben, wird ein Fehler zurückgegeben.

Beispiele

Die folgende SQL-Anweisung gibt den Winkel zurück, der in Grad von drei Eingabepunkten konvertiert wurde.

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

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

Die folgende SQL-Anweisung gibt den Winkel zurück, der in Grad von vier Eingabepunkten konvertiert wurde.

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