Partager via


STLength (type de données geometry)

S’applique à : point de terminaison d’analytique SQL Azure SQL Database Azure SQL Database dans Microsoft Fabric Warehouse

Retourne la longueur totale des éléments d’une instance geometry.

Syntaxe

  
.STLength ( )  

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Types de retour

Type de retour SQL Server : float

Type de retour CLR : SqlDouble

Remarques

Si une instance geometry est fermée, sa longueur est calculée en tant que longueur totale autour de l’instance ; la longueur d’un polygone correspond à son périmètre et la longueur d’un point est 0. La longueur d’un type geometrycollection correspond à la somme des longueurs des instances geometry qu’il contient.

STLength () fonctionne sur LineStrings valide et non valide. Généralement, un LineString n'est pas valide à cause du chevauchement des segments, qui peut être provoqué par des anomalies telles que des traces de longitude GPS inexactes. STLength () ne supprime pas les segments chevauchés ou non valides. Il les inclut dans la valeur de longueur retournée. La méthode MakeValid () peut supprimer les segments chevauchés d'un LineString.

Exemples

L'exemple suivant crée une instance LineString et utilise STLength() pour déterminer la longueur de l'instance.

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

Voir aussi

Méthodes OGC sur des instances geography