ST_POINT

描述

通过给定的 X 坐标值，Y 坐标值返回对应的 Point。

当前这个值只是在球面集合上有意义，X/Y 对应的是经度/纬度 (longitude/latitude);

语法

ST_POINT( <x>, <y>)

参数

参数	说明
<x>	点的 X 坐标值（经度），取值范围：-180.0 至 180.0（单位：度）
<y>	点的 Y 坐标值（纬度），取值范围：-90.0 至 90.0（单位：度）

返回值

返回 Point 类型的几何对象，表示一个二维坐标点。

• 若 或 超出有效经纬度范围，函数可能返回 NULL 或生成无效点（取决于 Doris 版本）。
• 若任一参数为 NULL，则返回 NULL。

举例

正常经纬度点

SELECT ST_AsText(ST_Point(24.7, 56.7));

+---------------------------------+
| st_astext(st_point(24.7, 56.7)) |
+---------------------------------+
| POINT (24.7 56.7)               |
+---------------------------------+

无效经度（超出范围）

mysql> SELECT ST_Point(200, 50);
+-------------------+
| ST_Point(200, 50) |
+-------------------+
| NULL              |
+-------------------+

无效纬度（超出范围）

mysql> SELECT ST_Point(116, -100);
+---------------------+
| ST_Point(116, -100) |
+---------------------+
| NULL                |
+---------------------+

任一参数为 NULL

mysql> SELECT ST_Point(NULL, 50);
+--------------------+
| ST_Point(NULL, 50) |
+--------------------+
| NULL               |
+--------------------+

mysql> SELECT ST_Point(50, NULL);
+--------------------+
| ST_Point(50, NULL) |
+--------------------+
| NULL               |
+--------------------+