12.16.3 Functions That Create Geometry Values from WKT Values — MySQL 5.7

12.16.3 Функции создания значений геометрии из значений WKT

Эти функции принимают в качестве аргументов представление Well-Known Text (WKT) и, необязательно, идентификатор системы пространственных ссылок (SRID). Они возвращают соответствующую геометрию.

ST_GeomFromText() принимает значение WKT любого типа геометрии в качестве своего первого аргумента. Другие функции предоставляют функции построения, специфичные для типа, для построения значений геометрии каждого типа геометрии.

Для описания формата WKT см. Формат Well-Known Text (WKT).

GeomCollFromText(wkt [, srid]), GeometryCollectionFromText(wkt [, srid])

ST_GeomCollFromText(), ST_GeometryCollectionFromText(), ST_GeomCollFromTxt(), GeomCollFromText(), и GeometryCollectionFromText() являются синонимами. Для получения дополнительной информации см. описание ST_GeomCollFromText().

GeomCollFromText() и GeometryCollectionFromText() устарели; ожидается, что они будут удалены в будущей версии MySQL. Используйте ST_GeomCollFromText() и ST_GeometryCollectionFromText() вместо них.
GeomFromText(wkt [, srid]), GeometryFromText(wkt [, srid])

ST_GeomFromText(), ST_GeometryFromText(), GeomFromText(), и GeometryFromText() являются синонимами. Для получения дополнительной информации см. описание ST_GeomFromText().

GeomFromText() и GeometryFromText() устарели; ожидается, что они будут удалены в будущей версии MySQL. Используйте ST_GeomFromText() и ST_GeometryFromText() вместо них.
LineFromText(wkt [, srid]), LineStringFromText(wkt [, srid])

ST_LineFromText(), ST_LineStringFromText(), LineFromText(), и LineStringFromText() являются синонимами. Для получения дополнительной информации см. описание ST_LineFromText().

LineFromText() и LineStringFromText() устарели; ожидается, что они будут удалены в будущей версии MySQL. Используйте ST_LineFromText() и ST_LineStringFromText() вместо них.
MLineFromText(wkt [, srid]), MultiLineStringFromText(wkt [, srid])

ST_MLineFromText(), ST_MultiLineStringFromText(), MLineFromText(), и MultiLineStringFromText() являются синонимами. Для получения дополнительной информации см. описание ST_MLineFromText().

MLineFromText() и MultiLineStringFromText() устарели; ожидается, что они будут удалены в будущей версии MySQL. Используйте ST_MLineFromText() и ST_MultiLineStringFromText() вместо них.
MPointFromText(wkt [, srid]), MultiPointFromText(wkt [, srid])

ST_MPointFromText(), ST_MultiPointFromText(), MPointFromText(), и MultiPointFromText() являются синонимами. Для получения дополнительной информации см. описание ST_MPointFromText().

MPointFromText() и MultiPointFromText() устарели; ожидается, что они будут удалены в будущей версии MySQL. Используйте ST_MPointFromText() и ST_MultiPointFromText() вместо них.
MPolyFromText(wkt [, srid]), MultiPolygonFromText(wkt [, srid])

ST_MPolyFromText(), ST_MultiPolygonFromText(), MPolyFromText(), и MultiPolygonFromText() являются синонимами. Для получения дополнительной информации см. описание ST_MPolyFromText().

MPolyFromText() и MultiPolygonFromText() устарели; ожидается, что они будут удалены в будущей версии MySQL. Используйте ST_MPolyFromText() и ST_MultiPolygonFromText() вместо них.
PointFromText(wkt [, srid])

ST_PointFromText() и PointFromText() являются синонимами. Для получения дополнительной информации см. описание ST_PointFromText().

PointFromText() устарела; ожидается, что она будет удалена в будущей версии MySQL. Используйте ST_PointFromText() вместо неё.
PolyFromText(wkt [, srid]), PolygonFromText(wkt [, srid])

ST_PolyFromText(), ST_PolygonFromText(), PolyFromText(), и PolygonFromText() являются синонимами. Для получения дополнительной информации см. описание ST_PolyFromText().

PolyFromText() и PolygonFromText() устарели; ожидается, что они будут удалены в будущей версии MySQL. Используйте ST_PolyFromText() и ST_PolygonFromText() вместо них.
ST_GeomCollFromText(wkt [, srid]), ST_GeometryCollectionFromText(wkt [, srid]), ST_GeomCollFromTxt(wkt [, srid])

Создает значение GeometryCollection, используя его представление WKT и SRID.

Если аргумент геометрии является NULL или не является синтаксически корректной геометрией, или если аргумент SRID является NULL, возвращаемое значение равно NULL.
```
mysql> SET @g = "MULTILINESTRING((10 10, 11 11), (9 9, 10 10))";
mysql> SELECT ST_AsText(ST_GeomCollFromText(@g));
+--------------------------------------------+
| ST_AsText(ST_GeomCollFromText(@g))         |
+--------------------------------------------+
| MULTILINESTRING((10 10,11 11),(9 9,10 10)) |
+--------------------------------------------+
```
ST_GeomCollFromText(), ST_GeometryCollectionFromText(), ST_GeomCollFromTxt(), GeomCollFromText(), и GeometryCollectionFromText() являются синонимами.

ST_GeomFromText(wkt [, srid]), ST_GeometryFromText(wkt [, srid])

Создаёт значение геометрии любого типа, используя его представление WKT и SRID.

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

ST_GeomFromText(), ST_GeometryFromText(), GeomFromText() и GeometryFromText() являются синонимами.
ST_LineFromText(wkt [, srid]), ST_LineStringFromText(wkt [, srid])

Создаёт значение типа LineString, используя его представление WKT и SRID.

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

ST_LineFromText(), ST_LineStringFromText(), LineFromText() и LineStringFromText() являются синонимами.
ST_MLineFromText(wkt [, srid]), ST_MultiLineStringFromText(wkt [, srid])

Создаёт значение типа MultiLineString, используя его представление WKT и SRID.

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

ST_MLineFromText(), ST_MultiLineStringFromText(), MLineFromText() и MultiLineStringFromText() являются синонимами.
ST_MPointFromText(wkt [, srid]), ST_MultiPointFromText(wkt [, srid])

Создаёт значение типа MultiPoint, используя его представление WKT и SRID.

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

Функции, такие как ST_MPointFromText() и ST_GeomFromText(), которые принимают представления значений MultiPoint в формате WKT, позволяют обрамлять отдельные точки внутри значений скобками. Например, оба следующих вызова функций являются допустимыми:
```
ST_MPointFromText('MULTIPOINT (1 1, 2 2, 3 3)')
ST_MPointFromText('MULTIPOINT ((1 1), (2 2), (3 3))')
```
ST_MPointFromText(), ST_MultiPointFromText(), MPointFromText() и MultiPointFromText() являются синонимами.
ST_MPolyFromText(wkt [, srid]), ST_MultiPolygonFromText(wkt [, srid])

Создаёт значение типа MultiPolygon, используя его представление WKT и SRID.

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

ST_MPolyFromText(), ST_MultiPolygonFromText(), MPolyFromText() и MultiPolygonFromText() являются синонимами.
ST_PointFromText(wkt [, srid])

Создаёт значение типа Point, используя его представление WKT и SRID.

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

ST_PointFromText() и PointFromText() являются синонимами.
ST_PolyFromText(wkt [, srid]), ST_PolygonFromText(wkt [, srid])

Создаёт значение типа Polygon, используя его представление WKT и SRID.

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

ST_PolyFromText(), ST_PolygonFromText(), PolyFromText() и PolygonFromText() являются синонимами.