Partilhar via


STLength (tipo de dados geography)

Retorna o comprimento total dos elementos em uma instância de geography ou as instâncias de geography em uma GeometryCollection.

Sintaxe

.STLength ( )

Tipos de retorno

SQL Server tipo de retorno: float

Tipo de retorno CLR: SqlDouble

Comentários

Se uma instância de geography 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 uma GeometryCollection é encontrado pelo cálculo da soma dos comprimentos de todas as instâncias de geography contidas na coleção.

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 geography;
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);
SELECT @g.STLength();

Consulte também

Outros recursos

Métodos do OGC em instâncias de geography