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

Apache Doris 中文参考:ST_DISTANCE_SPHERE

· 52CE 我爱测

计算地球两点之间的球面距离,单位为 米。传入的参数分别为 X 点的经度,X 点的纬度,Y 点的经度,Y 点的纬度。

描述

计算地球两点之间的球面距离,单位为 米。传入的参数分别为 X 点的经度,X 点的纬度,Y 点的经度,Y 点的纬度。

语法

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

参数

参数 说明
<x_lng> 点 X 的经度,类型为 DOUBLE,取值范围 [-180, 180](超出范围返回 NULL)。
<y_lng> 点 X 的纬度,类型为 DOUBLE,取值范围 [-90, 90](超出范围返回 NULL)。
<x_lat> 点 Y 的经度,类型为 DOUBLE,取值范围 [-180, 180](超出范围返回 NULL)
<y_lat> 点 Y 的纬度,类型为 DOUBLE,取值范围 [-90, 90](超出范围返回 NULL

返回值

返回两点之间的球面最短距离,单位为米(DOUBLE类型)

ST_DISTANCE_SPHERE 存在以下边缘情况:

  • 若任一输入参数为 NULL,返回 NULL。
  • 若经度超出 [-180, 180] 或纬度超出 [-90, 90],返回 NULL。
  • 若两点完全相同(经纬度数值一致),返回 0(距离为 0)。

举例

两点相同(返回 0)

select st_distance_sphere(116.35620117, 39.939093, 116.4274406433, 39.9020987219);
+----------------------------------------------------------------------------+
| st_distance_sphere(116.35620117, 39.939093, 116.4274406433, 39.9020987219) |
+----------------------------------------------------------------------------+
|                                                         7336.9135549995917 |
+----------------------------------------------------------------------------+

赤道上两点(经度差 1°,纬度 0°)

mysql> SELECT ST_DISTANCE_SPHERE(0, 0, 1, 0);
+--------------------------------+
| ST_DISTANCE_SPHERE(0, 0, 1, 0) |
+--------------------------------+
|             111195.10117748393 |
+--------------------------------+

实际跨经度 20° 的近距点


-- 点X(170, 0),点Y(-170, 0)(经度差20°,而非340°,取最短路径)
mysql> SELECT ST_DISTANCE_SPHERE(170, 0, -170, 0);
+-------------------------------------+
| ST_DISTANCE_SPHERE(170, 0, -170, 0) |
+-------------------------------------+
|                   2223902.023549678 |
+-------------------------------------+

无效参数(纬度超出范围)

mysql> SELECT ST_DISTANCE_SPHERE(116, 39, 120, 91);
+--------------------------------------+
| ST_DISTANCE_SPHERE(116, 39, 120, 91) |
+--------------------------------------+
|                                 NULL |
+--------------------------------------+

NULL 参数返回 NULL

mysql> SELECT ST_DISTANCE_SPHERE(NULL, 39.9, 116.4, 30);
+-------------------------------------------+
| ST_DISTANCE_SPHERE(NULL, 39.9, 116.4, 30) |
+-------------------------------------------+
|                                      NULL |
+-------------------------------------------+

两个坐标完全一样,返回0


mysql>  SELECT ST_DISTANCE_SPHERE(1,1 , 1, 1);
+--------------------------------+
| ST_DISTANCE_SPHERE(1,1 , 1, 1) |
+--------------------------------+
|                              0 |
+--------------------------------+

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

资料来源与适用范围

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

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

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