Алексей Паутов - MySQL: руководство профессионала

POLYGON

GEOMETRY может сохранять значения геометрии любого типа. Другие типы с одиночным значением (POINT, LINESTRING и POLYGON) ограничивают их значения специфическим типом геометрии.

Другие типы данных хранят совокупности значений:

MULTIPOINT

MULTILINESTRING

MULTIPOLYGON

GEOMETRYCOLLECTION

GEOMETRYCOLLECTION может сохранять совокупность объектов любого типа. Другие типы совокупности (MULTIPOINT, MULTILINESTRING, MULTIPOLYGON и GEOMETRYCOLLECTION) ограничивают элементы совокупности имеющими специфический тип геометрии.

Этот раздел описывает, как создать пространственные значения, использующие функции Well-Known Text и Well-Known Binary, которые определены в стандарте OpenGIS, и применить MySQL-функции.

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

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

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

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

GeomFromText( wkt [, srid ]), GeometryFromText( wkt [, srid ])

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

LineFromText( wkt [, srid ]), LineStringFromText( wkt [, srid ])

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

MLineFromText( wkt [, srid ]), MultiLineStringFromText( wkt [, srid ])

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

MPointFromText( wkt [, srid ]), MultiPointFromText( wkt [, srid ])

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

MPolyFromText( wkt [, srid ]), MultiPolygonFromText( wkt [, srid ])

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

PointFromText( wkt [, srid ])

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

PolyFromText( wkt [, srid ]), PolygonFromText( wkt [, srid ])

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

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

BdMPolyFromText( wkt , srid )

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

BdPolyFromText( wkt , srid )

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

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.

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.

MySQL обеспечивает стандартный способ создания пространственных столбцов для типов геометрии, например, через CREATE TABLE или ALTER TABLE. В настоящее время пространственные столбцы обеспечиваются для таблиц типов MyISAM, InnoDB, NDB и ARCHIVE.

Используйте инструкцию CREATE TABLE, чтобы создать таблицу с пространственным столбцом:CREATE TABLE geom (g GEOMETRY);