名前

ST_Azimuth — pointAとPointBで定義されるベクタの,水平面での方位をラジアン単位で返します.

概要

float ST_Azimuth(geometry pointA, geometry pointB);

説明

与えられたポイントジオメトリで定義される線分の方位を返し,二点が同位置にある場合はNULLを返します.返り値はラジアン単位です.

方位は基準面とポイントのあいたの角度(この場合はラジアン単位)と定義される数学的な概念です.

初出バージョン: 1.1.0

ST_Azimuthは,ST_Translateと併用して,垂直軸に沿ってオブジェクトをシフトさせる場合に,特に便利です. これの例として,upgis_lineshift Plpgsqlfunctions PostGIS wiki sectionを参照して下さい.

--Azimuth in degrees

SELECT ST_Azimuth(ST_MakePoint(1,2), ST_MakePoint(3,4))/(2*pi())*360 as degAz,
	ST_Azimuth(ST_MakePoint(3,4), ST_MakePoint(1,2))/(2*pi())*360 As degAzrev

degaz	degazrev
------	---------
45		225

関連情報

ST_MakePoint, ST_Translate