12.16.1 Spatial Function Reference — MySQL 5.7

12.16.1 Справочник по пространственным функциям

В следующей таблице перечислены все пространственные функции с кратким описанием каждой из них.

Таблица 12.21 Пространственные функции

Таблица 12.21 Пространственные функции
Имя	Описание	Устарело

`Area()`	Возвращение площади многоугольника или многоугольника	Да
`AsBinary()`, `AsWKB()`	Преобразование из внутреннего формата геометрии в WKB	Да
`AsText()`, `AsWKT()`	Преобразование из внутреннего формата геометрии в WKT	Да
`Buffer()`	Возвращение геометрии точек в заданной области от геометрии	Да
`Centroid()`	Возвращение центра тяжести как точки	Да
`Contains()`	Содержит ли MBR одной геометрии MBR другой	Да
`ConvexHull()`	Возвращение выпуклой оболочки геометрии	Да
`Crosses()`	Пересекает ли одна геометрия другую	Да
`Dimension()`	Размер геометрии	Да
`Disjoint()`	Являются ли MBR двух геометрий непересекающимися	Да
`EndPoint()`	Конечная точка LineString	Да
`Envelope()`	Возвращение MBR геометрии	Да
`Equals()`	Являются ли MBR двух геометрий равными	Да
`ExteriorRing()`	Возвращение внешней цепи многоугольника	Да
`GeomCollFromText()`, `GeometryCollectionFromText()`	Возвращение коллекции геометрий из WKT	Да
`GeomCollFromWKB()`, `GeometryCollectionFromWKB()`	Возвращение коллекции геометрий из WKB	Да
`GeometryCollection()`	Построение коллекции геометрий из геометрий
`GeometryN()`	Возвращение N-й геометрии из коллекции геометрий	Да
`GeometryType()`	Возвращение имени типа геометрии	Да
`GeomFromText()`, `GeometryFromText()`	Возвращение геометрии из WKT	Да
`GeomFromWKB()`, `GeometryFromWKB()`	Возвращение геометрии из WKB	Да
`GLength()`	Возвращение длины LineString	Да
`InteriorRingN()`	Возвращение N-й внутренней цепи многоугольника	Да
`Intersects()`	Пересекаются ли MBR двух геометрий	Да
`IsClosed()`	Является ли геометрия замкнутой и простой	Да
`IsEmpty()`	Является ли геометрия пустой	Да
`IsSimple()`	Является ли геометрия простой	Да
`LineFromText()`, `LineStringFromText()`	Построение LineString из WKT	Да
`LineFromWKB()`, `LineStringFromWKB()`	Построение LineString из WKB	Да
`LineString()`	Построение LineString из значений Point
`MBRContains()`	Содержит ли MBR одной геометрии MBR другой
`MBRCoveredBy()`	Покрывается ли один MBR другим
`MBRCovers()`	Покрывает ли один MBR другой
`MBRDisjoint()`	Являются ли MBR двух геометрий непересекающимися
`MBREqual()`	Являются ли MBR двух геометрий равными	Да
`MBREquals()`	Являются ли MBR двух геометрий равными
`MBRIntersects()`	Пересекаются ли MBR двух геометрий
`MBROverlaps()`	Перекрываются ли MBR двух геометрий
`MBRTouches()`	Соприкасаются ли MBR двух геометрий
`MBRWithin()`	Находится ли MBR одной геометрии внутри MBR другой
`MLineFromText()`, `MultiLineStringFromText()`	Построение MultiLineString из WKT	Да
`MLineFromWKB()`, `MultiLineStringFromWKB()`	Построение MultiLineString из WKB	Да
`MPointFromText()`, `MultiPointFromText()`	Построение MultiPoint из WKT	Да
`MPointFromWKB()`, `MultiPointFromWKB()`	Построение MultiPoint из WKB	Да
`MPolyFromText()`, `MultiPolygonFromText()`	Построение MultiPolygon из WKT	Да
`MPolyFromWKB()`, `MultiPolygonFromWKB()`	Построение MultiPolygon из WKB	Да
`MultiLineString()`	Построение MultiLineString из значений LineString
`MultiPoint()`	Построение MultiPoint из значений Point
`MultiPolygon()`	Построение MultiPolygon из значений Polygon
`NumGeometries()`	Возвращение количества геометрий в коллекции геометрий	Да
`NumInteriorRings()`	Возвращение количества внутренних цепей в многоугольнике	Да
`NumPoints()`	Возвращение количества точек в LineString	Да
`Overlaps()`	Перекрываются ли MBR двух геометрий	Да
`Point()`	Построение точки из координат
`PointFromText()`	Построение точки из WKT	Да
`PointFromWKB()`	Построение точки из WKB	Да
`PointN()`	Возвращение N-й точки из LineString	Да
`PolyFromText()`, `PolygonFromText()`	Построение многоугольника из WKT	Да

`PolyFromWKB()`, `PolygonFromWKB()`	Построить многоугольник из WKB	Да
`Polygon()`	Построить многоугольник из аргументов LineString
`Distance()`	Расстояние между двумя геометриями	Да
`SRID()`	Возвратить идентификатор системы пространственной привязки геометрии	Да
`ST_Area()`	Возвратить площадь многоугольника или многоугольника
`ST_AsBinary()`, `ST_AsWKB()`	Преобразование из внутреннего формата геометрии в WKB
`ST_AsGeoJSON()`	Генерация объекта GeoJSON из геометрии
`ST_AsText()`, `ST_AsWKT()`	Преобразование из внутреннего формата геометрии в WKT
`ST_Buffer()`	Возвратить геометрию точек в заданном расстоянии от геометрии
`ST_Buffer_Strategy()`	Опция стратегии для ST_Buffer()
`ST_Centroid()`	Возвратить центр масс в качестве точки
`ST_Contains()`	Содержит ли одна геометрия другую
`ST_ConvexHull()`	Возвратить выпуклую оболочку геометрии
`ST_Crosses()`	Пересекаются ли две геометрии
`ST_Difference()`	Возвратить разность двух геометрий
`ST_Dimension()`	Размерность геометрии
`ST_Disjoint()`	Непересекаются ли две геометрии
`ST_Distance()`	Расстояние между двумя геометриями
`ST_Distance_Sphere()`	Минимальное расстояние на сфере между двумя геометриями
`ST_EndPoint()`	Конечная точка LineString
`ST_Envelope()`	Возвратить прямоугольник минимального охватывающего прямоугольника
`ST_Equals()`	Равны ли две геометрии
`ST_ExteriorRing()`	Возвратить внешнюю линию многоугольника
`ST_GeoHash()`	Вычисление значения геохеша
`ST_GeomCollFromText()`, `ST_GeometryCollectionFromText()`, `ST_GeomCollFromTxt()`	Возвратить коллекцию геометрий из WKT
`ST_GeomCollFromWKB()`, `ST_GeometryCollectionFromWKB()`	Возвратить коллекцию геометрий из WKB
`ST_GeometryN()`	Возвратить N-ую геометрию из коллекции геометрий
`ST_GeometryType()`	Возвратить тип геометрии
`ST_GeomFromGeoJSON()`	Генерация геометрии из объекта GeoJSON
`ST_GeomFromText()`, `ST_GeometryFromText()`	Возвратить геометрию из WKT
`ST_GeomFromWKB()`, `ST_GeometryFromWKB()`	Возвратить геометрию из WKB
`ST_InteriorRingN()`	Возвратить N-ую внутреннюю линию многоугольника
`ST_Intersection()`	Возвратить пересечение двух геометрий
`ST_Intersects()`	Пересекаются ли две геометрии
`ST_IsClosed()`	Закрыта ли геометрия и простая ли она
`ST_IsEmpty()`	Пуста ли геометрия
`ST_IsSimple()`	Простая ли геометрия
`ST_IsValid()`	Валидна ли геометрия
`ST_LatFromGeoHash()`	Возвратить широту по значению геохеша
`ST_Length()`	Возвратить длину LineString
`ST_LineFromText()`, `ST_LineStringFromText()`	Построить LineString из WKT
`ST_LineFromWKB()`, `ST_LineStringFromWKB()`	Построить LineString из WKB
`ST_LongFromGeoHash()`	Возвратить долготу по значению геохеша
`ST_MakeEnvelope()`	Прямоугольник вокруг двух точек
`ST_MLineFromText()`, `ST_MultiLineStringFromText()`	Построить MultiLineString из WKT
`ST_MLineFromWKB()`, `ST_MultiLineStringFromWKB()`	Построить MultiLineString из WKB
`ST_MPointFromText()`, `ST_MultiPointFromText()`	Построить MultiPoint из WKT
`ST_MPointFromWKB()`, `ST_MultiPointFromWKB()`	Построить MultiPoint из WKB
`ST_MPolyFromText()`, `ST_MultiPolygonFromText()`	Построить MultiPolygon из WKT
`ST_MPolyFromWKB()`, `ST_MultiPolygonFromWKB()`	Построить MultiPolygon из WKB
`ST_NumGeometries()`	Возвратить количество геометрий в коллекции геометрий
`ST_NumInteriorRing()`, `ST_NumInteriorRings()`	Возвратить количество внутренних линий многоугольника
`ST_NumPoints()`	Возвратить количество точек в LineString
`ST_Overlaps()`	Пересекаются ли две геометрии
`ST_PointFromGeoHash()`	Преобразовать значение геохеша в значение POINT
`ST_PointFromText()`	Построить точку из WKT
`ST_PointFromWKB()`	Построить точку из WKB
`ST_PointN()`	Возвратить N-ую точку из LineString

`ST_PolyFromText()`, `ST_PolygonFromText()`	Построение многоугольника из WKT
`ST_PolyFromWKB()`, `ST_PolygonFromWKB()`	Построение многоугольника из WKB
`ST_Simplify()`	Возвращение упрощённой геометрии
`ST_SRID()`	Возвращение идентификатора системы пространственной привязки для геометрии
`ST_StartPoint()`	Начальная точка LineString
`ST_SymDifference()`	Возвращение симметричной разности двух геометрий
`ST_Touches()`	Касаются ли две геометрии друг друга
`ST_Union()`	Возвращение объединения двух геометрий
`ST_Validate()`	Возвращение проверенной геометрии
`ST_Within()`	Расположена ли одна геометрия внутри другой
`ST_X()`	Возвращение координаты X точки
`ST_Y()`	Возвращение координаты Y точки
`StartPoint()`	Начальная точка LineString	Да
`Touches()`	Касаются ли две геометрии друг друга	Да
`Within()`	Расположена ли MBR одной геометрии внутри MBR другой	Да
`X()`	Возвращение координаты X точки	Да
`Y()`	Возвращение координаты Y точки	Да