STCentroid (tipo de dados geometry)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzurePonto de extremidade de análises SQL no Microsoft FabricWarehouse no Microsoft Fabric

Retorna o centro geométrico de uma instância de geometry que consiste em um ou mais polígonos.

Sintaxe

  
.STCentroid ( )  

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Tipos de retorno

Tipo de retorno do SQL Server: geometry

Tipo de retorno do CLR: SqlGeometry

Tipo do OGC (Open Geospatial Consortium): Point

Comentários

STCentroid() retorna nulo se a instância de geometry não é um tipo Polygon, CurvePolygon ou MultiPolygon.

Exemplos

a. Calculando o centroide de uma instância de Polígono

O seguinte exemplo usa STCentroid() para calcular o centroide de uma instância de polygon``geometry:

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. Calculando o centroide de uma instância de CurvePolygon

O exemplo a seguir calcula o centroide de uma instância de CurvePolygon:

 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

Consulte Também

Métodos OGC em instâncias geometry