Перейти к содержимому
Последнее обновление

ST_POINT

Описание​

Создаёт геометрический объект Point по заданным координатам X и Y. В геопространственном контексте X/Y обычно обозначают долготу и широту соответственно,

Синтаксис​

ST_POINT( <x>, <y>)

Параметры​

ПараметрОписание
<x>Координата X (долгота) точки, диапазон: от -180.0 до 180.0 (в градусах)
<y>Координата Y (широта) точки, диапазон: от -90.0 до 90.0 (в градусах)

Возвращаемое значение​

Возвращает геометрический объект Point, представляющий 2D-координату.

  • Возвращает NULL, если или выходит за допустимые пределы долготы/широты.
  • Возвращает 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               |
+--------------------+

Report issue