Методы OGC для геометрических экземпляров

Относится к:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsАналитическая платформа (PDW)SQL база данных в Microsoft Fabric

Тип данных геометрии SQL Server реализует методы, определенные open Geospatial Consortium (OGC) Simple Features for SQL Specification версии 1.1.0. Эти стандартизированные методы обеспечивают соответствие пространственным вычислениям отраслевым стандартам и согласованно работают с другими геопространственных приложениями.

Тип данных геометрии представляет данные в системе координат Евклидана (плоская). Используйте методы OGC, если требуются стандартные пространственные операции для планарных данных, таких как вычисление областей, расстояний, пространственных связей и выполнение геометрических преобразований.

Соответствие стандартам OGC

Спецификация простых функций OGC определяет общую архитектуру для географической информации и предоставляет возможности реализации SQL для пространственных данных. Тип геометрии SQL Server соответствует этим спецификациям, что позволяет взаимодействовать с другими геопространственных системами.

Дополнительные сведения о спецификациях OGC см. в следующем разделе:

Свойства фигуры

Эти методы возвращают измерения и свойства, описывающие геометрическую фигуру.

Метод Description
STArea Возвращает общую площадь геометрического экземпляра в квадратных единицах на основе его идентификатора пространственной ссылки (SRID).
STLength Возвращает общую длину элементов в геометрическом экземпляре или всех элементах в коллекции геометрии.
STBoundary Возвращает границу геометрического экземпляра в виде геометрической геометрии нижнего измерения.
STCentroid Возвращает геометрический центр (центроид) геометрического экземпляра, состоящего из одного или нескольких многоугольников.
STEnvelope Возвращает минимальное выравнивание по оси ограничивающий прямоугольник (конверт) геометрического экземпляра.
STConvexHull Возвращает выпуклый корпус геометрического экземпляра, представляющий наименьший выпуклый многоугольник, содержащий все точки.

Представление геометрии

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

Метод Description
STAsBinary Возвращает представление объекта OGC Well-Known Binary (WKB) геометрического экземпляра.
STAsText Возвращает представление объекта OGC Well-Known Text (WKT) геометрического экземпляра.

Сведения о типе геометрии

Эти методы возвращают сведения о типе геометрии и характеристиках.

Метод Description
STGeometryType Возвращает имя типа OGC для геометрического экземпляра (Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon или GeometryCollection).
STDimension Возвращает максимальное измерение геометрического экземпляра: 0 для точек, 1 для кривых или 2 для поверхностей.
STSrid Возвращает идентификатор пространственной ссылки (SRID) экземпляра геометрии.

Доступ к точкам и кривым

Эти методы обращаются к определенным точкам и кривым в экземпляре геометрии.

Метод Description
STStartPoint Возвращает начальную точку геометрического экземпляра (для типов LineString).
STEndpoint Возвращает конечную точку геометрического экземпляра (для типов LineString).
STPointN Возвращает указанную точку из геометрического экземпляра.
STPointOnSurface Возвращает произвольную точку, гарантированно находиться в геометрическом экземпляре.
STCurveN (тип данных geometry) Возвращает указанную кривую из геометрического экземпляра, который является LineString, CircularString или CompoundCurve.
STCurveToLine (тип данных geometry) Возвращает многоугольник приближение геометрического экземпляра, содержащего сегменты круговой дуги.
STX Возвращает координату X экземпляра Point.
STY Возвращает координату Y экземпляра Point.

Доступ к кольцу многоугольника

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

Метод Description
STExteriorRing Возвращает внешнее кольцо экземпляра Polygon в виде LineString.
STInteriorRingN Возвращает указанное внутреннее кольцо экземпляра Polygon в виде LineString.
STNumInteriorRing Возвращает количество внутренних колец в экземпляре Polygon.

Доступ к коллекции

Эти методы работают с геометрическими коллекциями и возвращают сведения об их элементах.

Метод Description
STGeometryN Возвращает указанную геометрию из коллекции геометрии.
STNumGeometries Возвращает количество геометрий в коллекции геометрии.
STNumPoints Возвращает общее количество точек на каждой фигуре геометрического экземпляра.
STNumCurves (тип данных geometry) Возвращает количество кривых в одномерном экземпляре геометрии.

Тесты пространственных связей

Эти методы проверяют пространственные связи между экземплярами геометрии, возвращая значение 1 (true) или 0 (false).

Метод Description
STContains Возвращает значение 1, если геометрический экземпляр полностью содержит другой экземпляр.
STCrosses Возвращает значение 1, если геометрический экземпляр пересекает другой экземпляр.
STDisjoint Возвращает значение 1, если геометрический экземпляр пространственно разобщен от другого экземпляра (не пересекается).
STEquals Возвращает значение 1, если геометрический экземпляр представляет тот же набор точек, что и другой экземпляр.
STIntersects Возвращает значение 1, если геометрический экземпляр пересекается с другим экземпляром.
STOverlaps Возвращает значение 1, если геометрический экземпляр перекрывает другой экземпляр (они пересекаются и не содержат другого).
STRelate Возвращает значение 1, если геометрический экземпляр связан с другим экземпляром на основе шаблона модели разных пересечений (DE-9IM).
STTouches Возвращает 1, если геометрический экземпляр касается (делится точками границ, но не внутренними точками) другим экземпляром.
STWithin Возвращает значение 1, если геометрический экземпляр полностью находится в другом экземпляре.
STDistance Возвращает короткое расстояние между точкой в геометрическом экземпляре и точкой в другом экземпляре.

Пространственные операции

Эти методы создают новые геометрические экземпляры путем выполнения пространственных операций.

Метод Description
STBuffer Возвращает геометрический объект, представляющий все точки в пределах указанного расстояния от геометрического экземпляра.
STDifference Возвращает геометрию, представляющую набор точек из одного экземпляра, который не лежит в другом экземпляре.
STIntersection Возвращает геометрию, представляющую точки, в которых пересекаются два экземпляра геометрии.
STSymDifference Возвращает геометрию, представляющую точки в обоих экземплярах, но не в обоих (симметричное различие).
STUnion Возвращает геометрию, представляющую объединение (все точки) двух экземпляров геометрии.

Тесты на срок действия

Эти методы проверяют допустимость и свойства геометрических экземпляров.

Метод Description
STIsClosed Возвращает значение 1, если начальные и конечные точки экземпляра геометрии совпадают.
STIsEmpty Возвращает значение 1, если экземпляр геометрии пуст.
STIsRing Возвращает значение 1, если экземпляр геометрии закрыт и прост (не пересекается).
STIsSimple Возвращает 1, если геометрический экземпляр прост (не пересекается).
STIsValid Возвращает 1, если геометрический экземпляр хорошо сформирован в соответствии с его типом OGC.