14.16.7.5 GeometryCollection Property Functions — MySQL 8.4

14.16.7.5 Функции свойств GeometryCollection

Эти функции возвращают свойства значений GeometryCollection.

Если не указано иное, функции в этом разделе обрабатывают свои геометрические аргументы следующим образом:

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

Эти функции предназначены для получения свойств геометрических коллекций:

ST_GeometryN(gc, N)

Возвращает N-ю геометрию в значении GeometryCollection gc. Геометрии нумеруются, начиная с 1.

ST_GeometryN() обрабатывает свои аргументы так, как описано во введении к этому разделу.

mysql> SET @gc = 'GeometryCollection(Point(1 1),LineString(2 2, 3 3))';
mysql> SELECT ST_AsText(ST_GeometryN(ST_GeomFromText(@gc),1));
+-------------------------------------------------+
| ST_AsText(ST_GeometryN(ST_GeomFromText(@gc),1)) |
+-------------------------------------------------+
| POINT(1 1)                                      |
+-------------------------------------------------+

ST_NumGeometries(gc)

Возвращает количество геометрий в значении GeometryCollection gc.

ST_NumGeometries() обрабатывает свои аргументы так, как описано во введении к этому разделу.

mysql> SET @gc = 'GeometryCollection(Point(1 1),LineString(2 2, 3 3))';
mysql> SELECT ST_NumGeometries(ST_GeomFromText(@gc));
+----------------------------------------+
| ST_NumGeometries(ST_GeomFromText(@gc)) |
+----------------------------------------+
|                                      2 |
+----------------------------------------+