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

Apache Doris 中文参考:ST_ANGLE_SPHERE

· 52CE 我爱测

计算地球表面上两点之间的圆心角(单位为度)。输入参数依次为点 X 的经度、点 X 的纬度、点 Y 的经度、点 Y 的纬度。 圆心角是指地球球心处,连接两点的弧所对的角度。

描述

计算地球表面上两点之间的圆心角(单位为度)。输入参数依次为点 X 的经度、点 X 的纬度、点 Y 的经度、点 Y 的纬度。 圆心角是指地球球心处,连接两点的弧所对的角度。

语法

ST_ANGLE_SPHERE( <x_lng>, <x_lat>, <y_lng>, <y_lat>)

参数

参数 说明
<x_lng> 经度数据,类型为DOUBLE,合理的取值范围是 [-180, 180]
<y_lng> 经度数据,类型为DOUBLE,合理的取值范围是 [-180, 180]
<x_lat> 纬度数据,类型为DOUBLE,合理的取值范围是 [-90, 90]
<y_lat> 纬度数据,类型为DOUBLE,合理的取值范围是 [-90, 90]

返回值

返回两点之间的圆心角,单位为度,类型为 DOUBLE,范围为 [0, 180]。

ST_ANGLE_SPHERE 存在以下边缘情况:

  • 若任何输入参数为 NULL,返回 NULL。
  • 若任何坐标超出范围(如经度 > 180、纬度 <-90),返回 NULL。
  • 若两点为同一点(经纬度完全相同),返回 0。
  • 若两点为对映点(地球上直径相对的点),返回 180。

举例

两个邻近点的圆心角计算

select ST_Angle_Sphere(116.35620117, 39.939093, 116.4274406433, 39.9020987219);
+---------------------------------------------------------------------------+
| st_angle_sphere(116.35620117, 39.939093, 116.4274406433, 39.9020987219) |
+---------------------------------------------------------------------------+
|                                                        0.0659823452409903 |
+---------------------------------------------------------------------------+

赤道上经度差 45° 的两点

select ST_Angle_Sphere(0, 0, 45, 0);
+----------------------------------------+
| st_angle_sphere(0.0, 0.0, 45.0, 0.0) |
+----------------------------------------+
|                                     45 |
+----------------------------------------+

两点坐标完全相同


mysql> SELECT ST_ANGLE_SPHERE(30, 60, 30, 60);
+---------------------------------+
| ST_ANGLE_SPHERE(30, 60, 30, 60) |
+---------------------------------+
|                               0 |
+---------------------------------+

对映点(直径相对的点)

mysql> SELECT ST_ANGLE_SPHERE(0, 0, 180, 0);
+-------------------------------+
| ST_ANGLE_SPHERE(0, 0, 180, 0) |
+-------------------------------+
|                           180 |
+-------------------------------+

跨东西经度的两点(如 170°E 和 - 170°W)

mysql> SELECT ST_ANGLE_SPHERE(170, 30, -170, 30);
+------------------------------------+
| ST_ANGLE_SPHERE(170, 30, -170, 30) |
+------------------------------------+
|                 17.298330210575152 |
+------------------------------------+

跨赤道的南北两点

mysql> SELECT ST_ANGLE_SPHERE(0, 45, 0, -45);
+--------------------------------+
| ST_ANGLE_SPHERE(0, 45, 0, -45) |
+--------------------------------+
|              89.99999999999999 |
+--------------------------------+

无效经度(超出范围)

mysql> SELECT ST_ANGLE_SPHERE(190, 30, 10, 30);
+----------------------------------+
| ST_ANGLE_SPHERE(190, 30, 10, 30) |
+----------------------------------+
|                             NULL |
+----------------------------------+

任意参数为 NULL

mysql> SELECT ST_ANGLE_SPHERE(NULL, 30, 10, 30);
+-----------------------------------+
| ST_ANGLE_SPHERE(NULL, 30, 10, 30) |
+-----------------------------------+
|                              NULL |
+-----------------------------------+

纬度超出范围(如 91°N)

mysql> SELECT ST_ANGLE_SPHERE(0, 0, 180, 91);
+--------------------------------+
| ST_ANGLE_SPHERE(0, 0, 180, 91) |
+--------------------------------+
|                           NULL |
+--------------------------------+

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

资料来源与适用范围

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

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

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