大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:ST_AZIMUTH

· 52CE 我爱测

计算地球球面上两点之间的方位角(单位为弧度)。方位角是从起点(点 1)的真北方向线开始,顺时针旋转到两点连线的角度。

描述

计算地球球面上两点之间的方位角(单位为弧度)。方位角是从起点(点 1)的真北方向线开始,顺时针旋转到两点连线的角度。

方位角广泛用于导航和地理信息系统中,表示从一点到另一点的方向。

语法

ST_AZIMUTH( <point1>, <point2>)

参数

参数 说明
<point1> 起点,类型为 GeoPoint,用于计算方位角的基准点
<point2> 终点,类型为 GeoPoint,需要计算相对于起点的方向

返回值

返回两点之间的方位角,单位为弧度,范围为 [0, 2π)。方位角按顺时针方向从真北开始测量,具体方向对应关系:

  • 正北方:0 弧度
  • 正东方:π/2 弧度(约 1.5708)
  • 正南方:π 弧度(约 3.1416)
  • 正西方:3π/2 弧度(约 4.7124)

ST_Azimuth 存在以下边缘情况:

  • 若两点为同一点(经纬度完全相同),返回 NULL(方向无意义)。
  • 若两点为对映点(地球直径两端的点),返回 NULL(存在两个可能方向,无法唯一确定)。
  • 若输入参数不是 GeoPoint 类型(如线、多边形),或为空几何对象,返回NULL。

举例

正西方(从 (1,0) 到 (0,0))

SELECT st_azimuth(ST_Point(1, 0),ST_Point(0, 0));
+----------------------------------------------------+
| st_azimuth(st_point(1.0, 0.0), st_point(0.0, 0.0)) |
+----------------------------------------------------+
|                                   4.71238898038469 |
+----------------------------------------------------+

正东方(从 (0,0) 到 (1,0))

SELECT st_azimuth(ST_Point(0, 0),ST_Point(1, 0));
+----------------------------------------------------+
| st_azimuth(st_point(0.0, 0.0), st_point(1.0, 0.0)) |
+----------------------------------------------------+
|                                 1.5707963267948966 |
+----------------------------------------------------+

正北方(从 (0,0) 到 (0,1))

SELECT st_azimuth(ST_Point(0, 0),ST_Point(0, 1));
+----------------------------------------------------+
| st_azimuth(st_point(0.0, 0.0), st_point(0.0, 1.0)) |
+----------------------------------------------------+
|                                                  0 |
+----------------------------------------------------+

两点对映

SELECT st_azimuth(ST_Point(-30, 0),ST_Point(150, 0));
+--------------------------------------------------------+
| st_azimuth(st_point(-30.0, 0.0), st_point(150.0, 0.0)) |
+--------------------------------------------------------+
|                                                   NULL |
+--------------------------------------------------------+

东北方向(从 (0,0) 到 (1,1))

mysql> SELECT st_azimuth(ST_Point(0, 0), ST_Point(1, 1));
+--------------------------------------------+
| st_azimuth(ST_Point(0, 0), ST_Point(1, 1)) |
+--------------------------------------------+
|                         0.7854743216187384 |
+--------------------------------------------+

跨经度 180° 的东方(从 (170, 0) 到 (-170, 0))

mysql> SELECT st_azimuth(ST_Point(170, 0), ST_Point(-170, 0));
+-------------------------------------------------+
| st_azimuth(ST_Point(170, 0), ST_Point(-170, 0)) |
+-------------------------------------------------+
|                              1.5707963267948966 |
+-------------------------------------------------+

输入非点类型,返回NULL


mysql> SELECT st_azimuth(ST_LineFromText("LINESTRING (0 0, 1 1)"), ST_Point(1, 0));
+----------------------------------------------------------------------+
| st_azimuth(ST_LineFromText("LINESTRING (0 0, 1 1)"), ST_Point(1, 0)) |
+----------------------------------------------------------------------+
|                                                                 NULL |
+----------------------------------------------------------------------+

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。