Создание значенией геометрии с помощью функций WKB

 

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

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

 

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

Создает значение GEOMETRYCOLLECTION, использующее WKB представление и SRID.

 

GeomFromWKB(wkb [, srid ]), GeometryFromWKB(wkb [, srid ])

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

 

LineFromWKB(wkb [, srid ]), LineStringFromWKB(wkb [, srid ])

Создает значение LINESTRING, использующее WKB представление и SRID.

 

MLineFromWKB(wkb [, srid ]), MultiLineStringFromWKB(wkb [, srid ])

Создает значение MULTILINESTRING, использующее WKB представление и SRID.

 

MPointFromWKB(wkb [, srid ]), MultiPointFromWKB(wkb [, srid ])

Создает значение MULTIPOINT, использующее WKB представление и SRID.

 

MPolyFromWKB(wkb [, srid ]), MultiPolygonFromWKB(wkb [, srid ])

Создает значение MULTIPOLYGON, использующее WKB представление и SRID.

 

PointFromWKB(wkb [, srid ])

Создает значение POINT, использующее WKB представление и SRID.

 

PolyFromWKB(wkb [, srid ]), PolygonFromWKB(wkb [, srid ])

Создает значение POLYGON, использующее WKB представление и SRID.

Спецификация OpenGIS также описывает факультативные функции для построения значений Polygon или MultiPolygon, основанных на WKB представлении совокупности колец или закрытых значений LineString. Эти значения могут пересекаться. MySQL не выполняет эти функции:

 

BdMPolyFromWKB(wkb, srid)

Создает значение MultiPolygon из значения MultiLineString в формате WKB, содержащем произвольную совокупность закрытых значений LineString.

 

BdPolyFromWKB(wkb, srid)

Создает значение Polygon из значения MultiLineString в формате WKB, содержащем произвольную совокупность закрытых значений LineString.

 

4.4.2.3. Создание геометрии с использованием MySQL‑специфических функций

 

MySQL обеспечивает набор полезных ненормативных функций для создания геометрии с WKB представлениями. Функции, описанные в этом разделе, MySQL‑расширения спецификации OpenGIS. Результатами этих функций будут значения BLOB, содержащие WKB‑представления значений геометрии без SRID. Результаты этих функций могут заменяться как первый параметр любой функции в функциональном семействе GeomFromWKB().

 

GeometryCollection(g1, g2,…)

Создает значение WKB GeometryCollection. Если параметры не задают правильно построенное WKB представление геометрии, возвращаемое значение NULL.

 

LineString(pt1, pt2,…)

Создает значение WKB LineString из ряда WKB параметров Point. Если любой аргумент не задает правильный WKB Point, вернется NULL. Если число параметров Point меньше чем два, возвращаемое значение NULL.

 

MultiLineString(ls1, ls2,…)

Создает значение WKB MultiLineString, использующее WKB параметры LineString. Если любой параметр не WKB LineString, возвращаемое значение NULL.

 

MultiPoint(pt1, pt2,…)

Создает значение WKB MultiPoint, использующее WKB параметры Point. Если любой параметр не WKB Point, возвращаемое значение NULL.

 

MultiPolygon(poly1, poly2,…)

Создает значение WKB MultiPolygon из набора WKB параметров Polygon. Если любой параметр не WKB Polygon, возвращаемое значение NULL.

 

Point(x, y)

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

 

Polygon(ls1, ls2,…)

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