Name

ST_Azimuth — Renvoie l'azimut basé sur le nord d'une ligne entre deux points.

Synopsis

float ST_Azimuth(geometry origin, geometry target);

float ST_Azimuth(geography origin, geography target);

Description

Renvoie l'azimut en radians du point cible par rapport au point d'origine, ou NULL si les deux points coïncident. L'angle d'azimut est un angle positif dans le sens des aiguilles d'une montre, référencé à partir de l'axe Y positif (geometry) ou du méridien Nord (geography) : North = 0; Northeast = π/4; East = π/2; Southeast = 3π/4; South = π; Southwest 5π/4; West = 3π/2; Northwest = 7π/4.

Pour le type geography, la solution azimutale est connue sous le nom de inverse geodesic problem.

L'azimut est un concept mathématique défini comme l'angle entre un vecteur de référence et un point, avec des unités angulaires en radians. La valeur du résultat en radians peut être convertie en degrés à l'aide de la fonction PostgreSQL degrees().

L'azimut peut être utilisé conjointement avec ST_Translate pour déplacer un objet le long de son axe perpendiculaire. Voir la fonction upgis_lineshift() dans le PostGIS wiki pour une implémentation de ceci.

Disponibilité : 1.1.0

Amélioration : la prise en charge du type geography a été introduite dans la version 2.0.0.

Amélioration : 2.2.0 mesure sur sphéroïde effectuée avec GeographicLib pour améliorer la précision et la robustesse. Nécessite PROJ >= 4.9.0 pour profiter de la nouvelle fonctionnalité.

Exemples

Geometry Azimut en degrés

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

Bleu : origine Point(25,45) ; Vert : cible Point(75, 100) ; Jaune : axe Y ou Nord ; Rouge : angle d'azimut.

Bleu : origine Point(75, 100) ; Vert : cible Point(25, 45) ; Jaune : axe Y ou Nord ; Rouge : angle d'azimut.

Voir aussi

ST_Angle, ST_Point, ST_Translate, ST_Project, PostgreSQL Math Functions