STLength (tipo de datos geometry)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstancePunto de conexión de análisis SQL en Microsoft FabricAlmacenamiento en Microsoft Fabric

Devuelve la longitud total de los elementos de una instancia de geometry.

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 geometry 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 cualquier tipo geometrycollection es la suma de las longitudes de las instancias de geometry que contiene.

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 geometry;  
SET @g = geometry::STGeomFromText('LINESTRING(0 0, 2 2, 1 0)', 0);  
SELECT @g.STLength();  

Consulte también

Métodos de OGC en instancias de geometry