14.16.5 MySQL-Specific Functions That Create Geometry Values — MySQL 8.4

14.16.5 Функции MySQL для создания значений геометрии

MySQL предоставляет набор полезных нестандартных функций для создания значений геометрии. Функции, описанные в этом разделе, являются расширениями MySQL для спецификации OpenGIS.

Эти функции создают объекты геометрии из значений WKB или объектов геометрии в качестве аргументов. Если любой аргумент не является правильным представлением WKB или геометрии соответствующего типа объекта, возвращаемое значение равно NULL.

Например, вы можете вставить возвращаемое значение геометрии из Point() непосредственно в столбец POINT:

INSERT INTO t1 (pt_col) VALUES(Point(1,2));

GeomCollection(g [, g] ...)

Создаёт значение GeomCollection из аргументов геометрии.

GeomCollection() возвращает все соответствующие геометрии, содержащиеся в аргументах, даже если присутствует неподдерживаемая геометрия.

GeomCollection() без аргументов разрешена как способ создания пустой геометрии. Кроме того, такие функции, как ST_GeomFromText(), которые принимают аргументы WKT геометрических коллекций, понимают как синтаксис OpenGIS 'GEOMETRYCOLLECTION EMPTY', так и нестандартный синтаксис MySQL 'GEOMETRYCOLLECTION()'.

GeomCollection() и GeometryCollection() являются синонимами, при этом GeomCollection() является предпочтительной функцией.
GeometryCollection(g [, g] ...)

Создаёт значение GeomCollection из аргументов геометрии.

GeometryCollection() возвращает все соответствующие геометрии, содержащиеся в аргументах, даже если присутствует неподдерживаемая геометрия.

GeometryCollection() без аргументов разрешена как способ создания пустой геометрии. Кроме того, такие функции, как ST_GeomFromText(), которые принимают аргументы WKT геометрических коллекций, понимают как синтаксис OpenGIS 'GEOMETRYCOLLECTION EMPTY', так и нестандартный синтаксис MySQL 'GEOMETRYCOLLECTION()'.

GeomCollection() и GeometryCollection() являются синонимами, при этом GeomCollection() является предпочтительной функцией.
LineString(pt [, pt] ...)

Создаёт значение LineString из нескольких аргументов Point или WKB Point. Если количество аргументов меньше двух, возвращаемое значение равно NULL.
MultiLineString(ls [, ls] ...)

Создаёт значение MultiLineString, используя аргументы LineString или WKB LineString.
MultiPoint(pt [, pt2] ...)

Создаёт значение MultiPoint, используя аргументы Point или WKB Point.
MultiPolygon(poly [, poly] ...)

Создаёт значение MultiPolygon из набора аргументов Polygon или WKB Polygon.
Point(x, y)

Создаёт значение Point, используя его координаты.
Polygon(ls [, ls] ...)

Создаёт значение Polygon из набора аргументов LineString или WKB LineString. Если какой-либо аргумент не представляет собой LinearRing (то есть не является замкнутой и простой LineString), возвращаемое значение равно NULL.