ST_Distance_Sphere(g1, g2 [, radius])

Возвращает минимальное сферическое расстояние между двумя точками и/или многоточками на сфере в метрах или NULL, если какой-либо геометрический аргумент является NULL или пустым.

Вычисления используют сферическую Землю и настраиваемый радиус. Необязательный аргумент radius должен быть задан в метрах. Если он опущен, используется значение по умолчанию 6 370 986 метров. Возникает ошибка, если аргумент radius присутствует, но не является положительным.

Геометрические аргументы должны состоять из точек, определяющих значения координат (долгота, широта):

Поддерживаемые комбинации аргументов — (Point, Point), (Point, MultiPoint) и (MultiPoint, Point). Для других комбинаций возникает ошибка.

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

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 — если аргумент не синтаксически корректен или не геометрически валиден. Если аргумент является NULL, возвращаемое значение равно NULL. Геометрическая валидность определяется спецификацией OGC.

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

ST_IsValid() работает только для декартовой системы координат и требует геометрического аргумента со значением SRID 0. В противном случае возникает ошибка.

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. Если какой-либо аргумент является NULL, возвращаемое значение равно NULL.

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

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

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

ST_MakeEnvelope() требует Point геометрических аргументов со значением SRID 0. В противном случае возникает ошибка.

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

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)

Упрощает геометрию с помощью алгоритма Даугаса-Пекера и возвращает упрощенное значение того же типа. Если какой-либо аргумент является NULL, возвращаемое значение равно NULL.

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

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

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

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

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() работает только для декартовой системы координат и требует геометрического аргумента со значением SRID 0. В противном случае возникает ошибка.

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)          |
+------------------------------+