12.16.4 Functions That Create Geometry Values from WKB Values — MySQL 5.7

12.16.4 Функции, создающие значения геометрии из значений WKB

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

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

Эти функции также принимают объекты геометрии, возвращаемые функциями из Раздела 12.16.5, «Функции MySQL, специфичные для создания значений геометрии». Таким образом, эти функции можно использовать для предоставления первого аргумента функциям в этом разделе. Однако, начиная с MySQL 5.7.19, использование аргументов геометрии устарело и генерирует предупреждение. Аргументы геометрии не принимаются в MySQL 8.0. Чтобы мигрировать вызовы от использования аргументов геометрии к использованию аргументов WKB, следуйте этим рекомендациям:

Описание формата WKB см. в Формат Well-Known Binary (WKB).

Перепишите конструкции, такие как ST_GeomFromWKB(Point(0, 0)), как Point(0, 0).
Перепишите конструкции, такие как ST_GeomFromWKB(Point(0, 0), 4326), как ST_GeomFromWKB(ST_AsWKB(Point(0, 0)), 4326). (В MySQL 8.0 можно также использовать ST_SRID(Point(0, 0), 4326).)

GeomCollFromWKB(wkb [, srid]), GeometryCollectionFromWKB(wkb [, srid])

ST_GeomCollFromWKB(), ST_GeometryCollectionFromWKB(), GeomCollFromWKB(), и GeometryCollectionFromWKB() являются синонимами. Для получения дополнительной информации см. описание ST_GeomCollFromWKB().

GeomCollFromWKB() и GeometryCollectionFromWKB() устарели; ожидается, что они будут удалены в будущих выпусках MySQL. Используйте ST_GeomCollFromWKB() и ST_GeometryCollectionFromWKB() вместо них.
GeomFromWKB(wkb [, srid]), GeometryFromWKB(wkb [, srid])

ST_GeomFromWKB(), ST_GeometryFromWKB(), GeomFromWKB(), и GeometryFromWKB() являются синонимами. Для получения дополнительной информации см. описание ST_GeomFromWKB().

GeomFromWKB() и GeometryFromWKB() устарели; ожидается, что они будут удалены в будущих выпусках MySQL. Используйте ST_GeomFromWKB() и ST_GeometryFromWKB() вместо них.
LineFromWKB(wkb [, srid]), LineStringFromWKB(wkb [, srid])

ST_LineFromWKB(), ST_LineStringFromWKB(), LineFromWKB(), и LineStringFromWKB() являются синонимами. Для получения дополнительной информации см. описание ST_LineFromWKB().

LineFromWKB() и LineStringFromWKB() устарели; ожидается, что они будут удалены в будущих выпусках MySQL. Используйте ST_LineFromWKB() и ST_LineStringFromWKB() вместо них.
MLineFromWKB(wkb [, srid]), MultiLineStringFromWKB(wkb [, srid])

ST_MLineFromWKB(), ST_MultiLineStringFromWKB(), MLineFromWKB(), и MultiLineStringFromWKB() являются синонимами. Для получения дополнительной информации см. описание ST_MLineFromWKB().

MLineFromWKB() и MultiLineStringFromWKB() устарели; ожидается, что они будут удалены в будущих выпусках MySQL. Используйте ST_MLineFromWKB() и ST_MultiLineStringFromWKB() вместо них.
MPointFromWKB(wkb [, srid]), MultiPointFromWKB(wkb [, srid])

ST_MPointFromWKB(), ST_MultiPointFromWKB(), MPointFromWKB(), и MultiPointFromWKB() являются синонимами. Для получения дополнительной информации см. описание ST_MPointFromWKB().

MPointFromWKB() и MultiPointFromWKB() устарели; ожидается, что они будут удалены в будущих выпусках MySQL. Используйте ST_MPointFromWKB() и ST_MultiPointFromWKB() вместо них.
MPolyFromWKB(wkb [, srid]), MultiPolygonFromWKB(wkb [, srid])

ST_MPolyFromWKB(), ST_MultiPolygonFromWKB(), MPolyFromWKB(), и MultiPolygonFromWKB() являются синонимами. Для получения дополнительной информации см. описание ST_MPolyFromWKB().

MPolyFromWKB() и MultiPolygonFromWKB() устарели; ожидается, что они будут удалены в будущих выпусках MySQL. Используйте ST_MPolyFromWKB() и ST_MultiPolygonFromWKB() вместо них.
PointFromWKB(wkb [, srid])

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

PointFromWKB() устарел; ожидается, что он будет удален в будущих выпусках MySQL. Используйте ST_PointFromWKB() вместо него.
PolyFromWKB(wkb [, srid]), PolygonFromWKB(wkb [, srid])

ST_PolyFromWKB(), ST_PolygonFromWKB(), PolyFromWKB(), и PolygonFromWKB() являются синонимами. Для получения дополнительной информации см. описание ST_PolyFromWKB().

PolyFromWKB() и PolygonFromWKB() устарели; ожидается, что они будут удалены в будущих выпусках MySQL. Используйте ST_PolyFromWKB() и ST_PolygonFromWKB() вместо них.
ST_GeomCollFromWKB(wkb [, srid]), ST_GeometryCollectionFromWKB(wkb [, srid])

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

Результат будет NULL, если аргумент WKB или SRID является NULL.

ST_GeomCollFromWKB(), ST_GeometryCollectionFromWKB(), GeomCollFromWKB(), и GeometryCollectionFromWKB() являются синонимами.
ST_GeomFromWKB(wkb [, srid]), ST_GeometryFromWKB(wkb [, srid])

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

Результат будет NULL, если аргумент WKB или SRID является NULL.

ST_GeomFromWKB(), ST_GeometryFromWKB(), GeomFromWKB(), и GeometryFromWKB() являются синонимами.

ST_LineFromWKB(wkb [, srid]), ST_LineStringFromWKB(wkb [, srid])

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

Результатом является NULL, если аргумент WKB или SRID является NULL.

ST_LineFromWKB(), ST_LineStringFromWKB(), LineFromWKB() и LineStringFromWKB() — синонимы.
ST_MLineFromWKB(wkb [, srid]), ST_MultiLineStringFromWKB(wkb [, srid])

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

Результатом является NULL, если аргумент WKB или SRID является NULL.

ST_MLineFromWKB(), ST_MultiLineStringFromWKB(), MLineFromWKB() и MultiLineStringFromWKB() — синонимы.
ST_MPointFromWKB(wkb [, srid]), ST_MultiPointFromWKB(wkb [, srid])

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

Результатом является NULL, если аргумент WKB или SRID является NULL.

ST_MPointFromWKB(), ST_MultiPointFromWKB(), MPointFromWKB() и MultiPointFromWKB() — синонимы.
ST_MPolyFromWKB(wkb [, srid]), ST_MultiPolygonFromWKB(wkb [, srid])

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

Результатом является NULL, если аргумент WKB или SRID является NULL.

ST_MPolyFromWKB(), ST_MultiPolygonFromWKB(), MPolyFromWKB() и MultiPolygonFromWKB() — синонимы.
ST_PointFromWKB(wkb [, srid])

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

Результатом является NULL, если аргумент WKB или SRID является NULL.

ST_PointFromWKB() и PointFromWKB() — синонимы.
ST_PolyFromWKB(wkb [, srid]), ST_PolygonFromWKB(wkb [, srid])

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

Результатом является NULL, если аргумент WKB или SRID является NULL.

ST_PolyFromWKB(), ST_PolygonFromWKB(), PolyFromWKB() и PolygonFromWKB() — синонимы.