STLength (tipo de dados de geometria)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Retorna o comprimento total dos elementos em uma ocorrência de geometria .

Syntax

  
.STLength ( )  

Tipos de devolução

Tipo de retorno do SQL Server: float

Tipo de retorno CLR: SqlDouble

Remarks

Se uma ocorrência de geometria for fechada, seu comprimento será calculado como o comprimento total ao redor da instância; O comprimento de qualquer polígono é o seu perímetro e o comprimento de um ponto é 0. O comprimento de qualquer tipo de geometria é a soma dos comprimentos de suas ocorrências de geometria contidas.

STLength() funciona em LineStrings válidos e inválidos. Normalmente, um LineString é inválido devido à sobreposição de segmentos, que podem ser causados por anomalias, como rastreamentos GPS imprecisos. STLength() não remove segmentos sobrepostos ou inválidos. Inclui segmentos sobrepostos e inválidos no valor de comprimento que retorna. O método MakeValid() pode remover segmentos sobrepostos de um LineString.

Examples

O exemplo a seguir cria uma LineString instância e usa STLength() para localizar o comprimento da instância.

DECLARE @g geometry;  
SET @g = geometry::STGeomFromText('LINESTRING(0 0, 2 2, 1 0)', 0);  
SELECT @g.STLength();  

Ver também

Métodos OGC em instâncias de geometria