STLength (tipo de datos geography)

Se aplica a: SQL ServerAzure SQL Database Azure SQL Instancia administrada

Devuelve la longitud total de los elementos de una instancia de geography o las instancias de geography incluidas en una colección GeometryCollection.

Sintaxis

  
.STLength ( )  

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Tipos de valor devuelto

Tipo de valor devuelto de SQL Server: float

Tipo de valor devuelto de CLR: SqlDouble

Comentarios

Si se trata de una instancia de geography cerrada, su longitud se calcula como la longitud total alrededor de la instancia; la longitud de cualquier polígono es su perímetro y la longitud de un punto es 0. La longitud de una colección de GeometryCollection se halla calculando la suma de las longitudes de todas las instancias de geography contenidas dentro de la colección.

STLength() funciona con LineString válidos y no válidos. Si un LineString no es válido normalmente se debe a la superposición de segmentos, lo cual se puede deber a anomalías como seguimientos de GPS inexactos. STLength() no quita segmentos superpuestos o no válidos. Incluye los segmentos superpuestos y no válidos en el valor de longitud que devuelve. El método MakeValid() puede quitar segmentos superpuestos de un LineString.

Ejemplos

En el ejemplo siguiente se crea una instancia de LineString y se usa STLength() para averiguar la longitud de dicha instancia.

DECLARE @g geography;  
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);  
SELECT @g.STLength();  

Consulte también

Métodos de OGC en instancias de Geography