STLength (tipo de dados geometry)
Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Banco de Dados SQL no Microsoft Fabric
Retorna o comprimento total dos elementos em uma instância de geometry.
Sintaxe
.STLength ( )
Tipos de retorno
Tipo de retorno do SQL Server: float
Tipo de retorno do CLR: SqlDouble
Comentários
Se uma instância de geometry for fechada, seu comprimento será calculado como o comprimento total ao redor da instância. O comprimento de qualquer polígono é seu perímetro e o comprimento de um ponto é 0. O comprimento de qualquer tipo de geometrycollection é a soma dos comprimentos de suas instâncias de geometry independentes.
STLength () funciona em LineStrings válidos e inválidos. Em geral, um LineString é inválido devido aos segmentos sobrepostos, que podem ser causados por anomalias como rastreamentos de GPS imprecisos. STLength () não remove segmentos sobrepostos ou inválidos. Ele inclui segmentos sobrepostos e inválidos no valor de comprimento que ele retorna. O método MakeValid () pode remover segmentos sobrepostos de um LineString.
Exemplos
O exemplo a seguir cria uma instância LineString
e usa STLength()
para encontrar o comprimento da instância.
DECLARE @g geometry;
SET @g = geometry::STGeomFromText('LINESTRING(0 0, 2 2, 1 0)', 0);
SELECT @g.STLength();