STCentroid (тип данных geometry)STCentroid (geometry Data Type)

Применимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) ДаБаза данных SQL AzureAzure SQL DatabaseYesБаза данных SQL AzureAzure SQL DatabaseПрименимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) ДаБаза данных SQL AzureAzure SQL DatabaseYesБаза данных SQL AzureAzure SQL Database

Возвращает геометрический центр экземпляра geometry, состоящего из одного или нескольких многоугольников.Returns the geometric center of a geometry instance that consists of one or more polygons.

СинтаксисSyntax

  
.STCentroid ( )  

Примечание

Ссылки на описание синтаксиса Transact-SQL для SQL Server 2014 и более ранних версий, см. в статье Документация по предыдущим версиям.To view Transact-SQL syntax for SQL Server 2014 and earlier, see Previous versions documentation.

Типы возвращаемых данныхReturn Types

Тип возвращаемых данных SQL ServerSQL Server: geometrySQL ServerSQL Server return type: geometry

Тип возвращаемых данных CLR: SqlGeometryCLR return type: SqlGeometry

Тип открытого геопространственного консорциума (OGC): PointOpen Geospatial Consortium (OGC) type: Point

КомментарииRemarks

STCentroid() возвращает значение NULL, если экземпляр geometry не относится к типу Polygon, CurvePolygon или MultiPolygon.STCentroid() returns null if the geometry instance is not a Polygon, CurvePolygon, or MultiPolygon type.

ПримерыExamples

A.A. Вычисление центроида экземпляра объекта PolygonComputing the centroid of a Polygon instance

В приведенном ниже примере метод STCentroid() используется для вычисления центроида экземпляра polygon``geometry.The following example uses STCentroid() to compute the centroid of a polygon``geometry instance:

DECLARE @g geometry;  
SET @g = geometry::STGeomFromText('POLYGON((0 0, 3 0, 3 3, 0 3, 0 0),(2 2, 2 1, 1 1, 1 2, 2 2))', 0);  
SELECT @g.STCentroid().ToString();  

Б.B. Вычисление центроида экземпляра объекта CurvePolygonComputing the centroid of a CurvePolygon instance

В следующем примере вычисляется центроид экземпляра CurvePolygon.The following example computes the centroid for a CurvePolygon instance:

 DECLARE @g geometry = 'CURVEPOLYGON(CIRCULARSTRING(0 4, 4 0, 8 4, 4 8, 0 4), CIRCULARSTRING(2 4, 4 2, 6 4, 4 6, 2 4))';  
 SELECT @g.STCentroid().ToString() AS Centroid

См. такжеSee Also

Методы OGC в экземплярах GeometryOGC Methods on Geometry Instances