Если какой-либо аргумент является NULL, возвращаемое значение равно NULL.

Если какой-либо геометрический аргумент не является синтаксически корректной геометрией, возникает ошибка.

Если какой-либо геометрический аргумент является синтаксически корректной геометрией в неопределенной системе пространственной привязки (SRS), возникает ошибка.

Для функций, принимающих несколько геометрических аргументов, если эти аргументы не находятся в одной и той же системе SRS, возникает ошибка.

В противном случае, возвращаемое значение является не-NULL.

ST_Distance_Sphere(g1, g2 [, radius])

Возвращает минимальное сферическое расстояние между Point или MultiPoint аргументами на сфере в метрах. (Для расчётов расстояний общего назначения, см. функцию ST_Distance().) Необязательный аргумент radius должен быть указан в метрах.

Если оба параметра геометрии являются допустимыми декартовыми Point или MultiPoint значениями в SRID 0, возвращаемое значение — кратчайшее расстояние между двумя геометриями на сфере с заданным радиусом. Если аргумент опущен, используется значение по умолчанию — 6 370 986 метров. Координаты точки X и Y интерпретируются как долгота и широта соответственно в градусах.

Если оба параметра геометрии являются допустимыми Point или MultiPoint значениями в географической системе координат (SRS), возвращаемое значение — кратчайшее расстояние между двумя геометриями на сфере с заданным радиусом. Если аргумент опущен, используется значение по умолчанию, равное среднему радиусу, определяемому как (2a+b)/3, где a — большая полуось, а b — малая полуось SRS.

ST_Distance_Sphere() обрабатывает свои аргументы так, как описано в введении к этому разделу, за исключением следующих моментов:

mysql> SET @pt1 = ST_GeomFromText('POINT(0 0)');
mysql> SET @pt2 = ST_GeomFromText('POINT(180 0)');
mysql> SELECT ST_Distance_Sphere(@pt1, @pt2);
+--------------------------------+
| ST_Distance_Sphere(@pt1, @pt2) |
+--------------------------------+
|             20015042.813723423 |
+--------------------------------+

ST_IsValid(g)

Возвращает 1, если аргумент геометрически корректен, 0 — если нет. Корректность геометрии определяется спецификацией OGC.

Единственной допустимой пустой геометрией является пустой набор геометрий. ST_IsValid() возвращает 1 в этом случае. MySQL не поддерживает значения GIS EMPTY, такие как POINT EMPTY.

ST_IsValid() обрабатывает свои аргументы так, как описано в введении к этому разделу, за исключением следующего момента:

mysql> SET @ls1 = ST_GeomFromText('LINESTRING(0 0,-0.00 0,0.0 0)');
mysql> SET @ls2 = ST_GeomFromText('LINESTRING(0 0, 1 1)');
mysql> SELECT ST_IsValid(@ls1);
+------------------+
| ST_IsValid(@ls1) |
+------------------+
|                0 |
+------------------+
mysql> SELECT ST_IsValid(@ls2);
+------------------+
| ST_IsValid(@ls2) |
+------------------+
|                1 |
+------------------+

ST_MakeEnvelope(pt1, pt2)

Возвращает прямоугольник, охватывающий две точки, как Point, LineString или Polygon.

Расчёты выполняются в декартовой системе координат, а не на сфере, сфероиде или Земле.

Для двух точек pt1 и pt2, функция ST_MakeEnvelope() создаёт геометрию результата на абстрактной плоскости следующим образом:

Результат геометрии имеет SRID 0.

ST_MakeEnvelope() обрабатывает свои аргументы так, как описано в введении к этому разделу, за исключением следующих моментов:

mysql> SET @pt1 = ST_GeomFromText('POINT(0 0)');
mysql> SET @pt2 = ST_GeomFromText('POINT(1 1)');
mysql> SELECT ST_AsText(ST_MakeEnvelope(@pt1, @pt2));
+----------------------------------------+
| ST_AsText(ST_MakeEnvelope(@pt1, @pt2)) |
+----------------------------------------+
| POLYGON((0 0,1 0,1 1,0 1,0 0))         |
+----------------------------------------+

ST_Simplify(g, max_distance)

Упрощает геометрию с помощью алгоритма Дугласа-Пекера и возвращает упрощённое значение того же типа.

Геометрия может быть любого типа, хотя алгоритм Дугласа-Пекера может не обрабатывать каждый тип. Набор геометрий обрабатывается поочерёдно, передавая его компоненты алгоритму упрощения, а возвращаемые геометрии помещаются в набор геометрий в результате.

Аргумент max_distance — это расстояние (в единицах входных координат) вершины до других отрезков, которые нужно удалить. Вершины, находящиеся на расстоянии, меньшем или равном этому значению, от упрощённых линий, удаляются.

Согласно Boost.Geometry, геометрии могут стать некорректными в результате процесса упрощения, и процесс может создавать самопересечения. Чтобы проверить корректность результата, передайте его в функцию ST_IsValid().

ST_Simplify() обрабатывает свои аргументы так, как описано в введении к этому разделу, за исключением следующего момента:

mysql> SET @g = ST_GeomFromText('LINESTRING(0 0,0 1,1 1,1 2,2 2,2 3,3 3)');
mysql> SELECT ST_AsText(ST_Simplify(@g, 0.5));
+---------------------------------+
| ST_AsText(ST_Simplify(@g, 0.5)) |
+---------------------------------+
| LINESTRING(0 0,0 1,1 1,2 3,3 3) |
+---------------------------------+
mysql> SELECT ST_AsText(ST_Simplify(@g, 1.0));
+---------------------------------+
| ST_AsText(ST_Simplify(@g, 1.0)) |
+---------------------------------+
| LINESTRING(0 0,3 3)             |
+---------------------------------+

ST_Validate(g)

Проверяет геометрию по спецификации OGC. Геометрия может быть синтаксически корректной (значение WKB плюс SRID), но геометрически некорректной. Например, этот многоугольник геометрически некорректен: POLYGON((0 0, 0 0, 0 0, 0 0, 0 0))

ST_Validate() возвращает геометрию, если она синтаксически корректна и геометрически корректна, NULL если аргумент не синтаксически корректен, не геометрически корректен или является NULL.

ST_Validate() может использоваться для фильтрации некорректных данных геометрии, хотя с затратами. Для приложений, требующих более точных результатов, не искажённых некорректными данными, эта плата может быть оправдана.

Если аргумент геометрии корректен, он возвращается как есть, за исключением того, что если у входного Polygon или MultiPolygon есть кольца по часовой стрелке, эти кольца инвертируются перед проверкой на корректность. Если геометрия корректна, возвращается значение с инвертированными кольцами.

Единственной допустимой пустой геометрией является пустой набор геометрий. ST_Validate() возвращает его напрямую без дальнейшей проверки в этом случае.

ST_Validate() обрабатывает свои аргументы так, как описано в введении к этому разделу, за исключением перечисленных ниже моментов:

mysql> SET @ls1 = ST_GeomFromText('LINESTRING(0 0)');
mysql> SET @ls2 = ST_GeomFromText('LINESTRING(0 0, 1 1)');
mysql> SELECT ST_AsText(ST_Validate(@ls1));
+------------------------------+
| ST_AsText(ST_Validate(@ls1)) |
+------------------------------+
| NULL                         |
+------------------------------+
mysql> SELECT ST_AsText(ST_Validate(@ls2));
+------------------------------+
| ST_AsText(ST_Validate(@ls2)) |
+------------------------------+
| LINESTRING(0 0,1 1)          |
+------------------------------+