14.16.4 Functions That Create Geometry Values from WKB Values — MySQL 9.2

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

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

Функции в этом разделе обнаруживают аргументы в системах пространственной привязки (SRS) декартовой или географической системы координат и возвращают результаты, соответствующие SRS.

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

До MySQL 9.2 эти функции также принимали объекты геометрии, возвращаемые функциями в разделе 14.16.5, «Функции MySQL, специфичные для создания значений геометрии». Аргументы геометрии больше не допускаются и вызывают ошибку. Чтобы перенести вызовы из использования аргументов геометрии на использование аргументов WKB, следуйте этим рекомендациям:

Перепишите конструкции, такие как ST_GeomFromWKB(Point(0, 0)), как Point(0, 0).
Перепишите конструкции, такие как ST_GeomFromWKB(Point(0, 0), 4326), как ST_SRID(Point(0, 0), 4326) или ST_GeomFromWKB(ST_AsWKB(Point(0, 0)), 4326).

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

Если аргумент WKB или SRID является NULL, значение возврата является NULL.
По умолчанию географические координаты (широта, долгота) интерпретируются в порядке, указанном системой пространственной привязки аргументов геометрии. Можно указать необязательный аргумент options для переопределения порядка осей по умолчанию. options состоит из списка key=value, разделенных запятыми. Единственное разрешенное значение key — это axis-order, с разрешенными значениями lat-long, long-lat и srid-defined (по умолчанию).

Если аргумент options равен NULL, значение возврата равно NULL. Если аргумент options недопустим, возникает ошибка с указанием причины.
Если аргумент SRID относится к неопределенной системе пространственной привязки (SRS), возникает ошибка.
Для аргументов геометрии географических SRS, если какой-либо аргумент имеет долготу или широту, выходящие за пределы диапазона, возникает ошибка:
- Если значение долготы не находится в диапазоне (−180, 180], возникает ошибка.
- Если значение широты не находится в диапазоне [−90, 90], возникает ошибка.
Указанные диапазоны приведены в градусах. Если SRS использует другую единицу, диапазон использует соответствующие значения в своей единице. Точные пределы диапазона незначительно отличаются из-за арифметики с плавающей запятой.

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

ST_GeomCollFromWKB(wkb [, srid [, options]]), ST_GeometryCollectionFromWKB(wkb [, srid [, options]])

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

Эти функции обрабатывают свои аргументы, как описано во введении к этому разделу.
ST_GeomFromWKB(wkb [, srid [, options]]), ST_GeometryFromWKB(wkb [, srid [, options]])

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

Эти функции обрабатывают свои аргументы, как описано во введении к этому разделу.
ST_LineFromWKB(wkb [, srid [, options]]), ST_LineStringFromWKB(wkb [, srid [, options]])

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

Эти функции обрабатывают свои аргументы, как описано во введении к этому разделу.
ST_MLineFromWKB(wkb [, srid [, options]]), ST_MultiLineStringFromWKB(wkb [, srid [, options]])

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

Эти функции обрабатывают свои аргументы, как описано во введении к этому разделу.
ST_MPointFromWKB(wkb [, srid [, options]]), ST_MultiPointFromWKB(wkb [, srid [, options]])

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

Эти функции обрабатывают свои аргументы, как описано во введении к этому разделу.
ST_MPolyFromWKB(wkb [, srid [, options]]), ST_MultiPolygonFromWKB(wkb [, srid [, options]])

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

Эти функции обрабатывают свои аргументы, как описано во введении к этому разделу.
ST_PointFromWKB(wkb [, srid [, options]])

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

ST_PointFromWKB() обрабатывает свои аргументы, как описано во введении к этому разделу.
ST_PolyFromWKB(wkb [, srid [, options]]), ST_PolygonFromWKB(wkb [, srid [, options]])

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

Эти функции обрабатывают свои аргументы, как описано во введении к этому разделу.