STLength (type de données geography)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Retourne la longueur totale des éléments d’une instance geography ou des instances geography présentes dans GeometryCollection.

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 geography 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 de GeometryCollection est déterminée en calculant la somme des longueurs de toutes les instances geography contenues dans la collection.

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

Voir aussi

Méthodes OGC sur des instances Geography