ST_Azimuth
Prev  7.12. Messfunktionen  Next

Name

ST_Azimuth — Gibt die 2-dimenionale kürzeste Strecke zwischen zwei Geometrien als Linie zurück

Synopsis

float ST_Azimuth(geometry origin, geometry target);

float ST_Azimuth(geography origin, geography target);

Beschreibung

Gibt den Azimutwinkel des Zielpunkts vom Ursprungspunkt in Bogenmaß zurück oder NULL, wenn die beiden Punkte übereinstimmen. Der Azimutwinkel ist ein positiver Winkel im Uhrzeigersinn, der sich auf die positive Y-Achse (Geometrie) oder den Nordmeridian (Geografie) bezieht: Nord = 0; Nordost = π/4; Ost = π/2; Südost = 3π/4; Süd = π; Südwest 5π/4; West = 3π/2; Nordwest = 7π/4.

Für den Typ Geografie ist die Azimutlösung als inverses geodätisches Problem bekannt.

Der Azimut ist ein mathematisches Konzept, das als der Winkel zwischen einem Referenzvektor und einem Punkt definiert ist, mit Winkeleinheiten im Bogenmaß. Der Ergebniswert in Bogenmaß kann mit der PostgreSQL-Funktion degrees() in Grad umgerechnet werden.

Der Azimut ist in Verbindung mit ST_Translate besonders nützlich, weil damit ein Objekt entlang seiner rechtwinkeligen Achse verschoben werden kann. Siehe dazu die Funktion "upgis_lineshift", in dem Abschnitt Plpgsqlfunctions des PostGIS Wiki, für ein Beispiel.

Verfügbarkeit: 1.1.0

Erweiterung: mit 2.0.0 wurde die Unterstützung des geographischen Datentyps eingeführt.

Erweiterung: 2.2.0 die Messungen auf dem Referenzellipsoid werden mit der Bibliothek "GeographicLib" durchgeführt. Dadurch wurde die Genauigkeit und die Robustheit erhöht. Um die Vorteile dieser neuen Funktionalität zu nutzen, benötigen Sie Proj >= 4.9.0.

Beispiele

Geometrischer Datentyp - Azimut in Grad 

SELECT degrees(ST_Azimuth( ST_Point(25, 45),  ST_Point(75, 100))) AS degA_B,
       degrees(ST_Azimuth( ST_Point(75, 100), ST_Point(25, 45) )) AS degB_A;

      dega_b       |     degb_a
------------------+------------------
 42.2736890060937 | 222.273689006094

Blau: Ursprung Punkt(25,45); Grün: Zielpunkt(75, 100); Gelb: Y-Achse oder Norden; Rot: Azimutwinkel.

Blau: Ursprung Punkt(75, 100); Grün: Ziel Punkt(25, 45); Gelb: Y-Achse oder Norden; Rot: Azimutwinkel.