STLength (type de données geography)STLength (geography Data Type)

S’APPLIQUE À : ouiSQL Server (à partir de 2012) ouiAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server (starting with 2012) yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Retourne la longueur totale des éléments d’une instance geography ou des instances geography présentes dans GeometryCollection.Returns the total length of the elements in a geography instance or the geography instances within a GeometryCollection.

SyntaxeSyntax

  
.STLength ( )  

Types de retourReturn Types

Type de retour SQL ServerSQL Server : floatSQL ServerSQL Server return type: float

Type de retour CLR : SqlDoubleCLR return type: SqlDouble

Notes Remarks

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.If a geography instance is closed, its length is calculated as the total length around the instance; the length of any polygon is its perimeter, and the length of a point is 0. La longueur de GeometryCollection est déterminée en calculant la somme des longueurs de toutes les instances geography contenues dans la collection.The length of a GeometryCollection is found by calculating the sum of the lengths of all of the geography instances contained within the collection.

STLength () fonctionne sur LineStrings valide et non valide.STLength() works on both valid and invalid LineStrings. 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.Typically a LineString is invalid due to overlapping segments, which may be caused by anomalies such as inaccurate GPS traces. STLength () ne supprime pas les segments chevauchés ou non valides.STLength() does not remove overlapping or invalid segments. Il les inclut dans la valeur de longueur retournée.It includes overlapping and invalid segments in the length value that it returns. La méthode MakeValid () peut supprimer les segments chevauchés d'un LineString.The MakeValid() method can remove overlapping segments from a LineString.

ExemplesExamples

L'exemple suivant crée une instance LineString et utilise STLength() pour déterminer la longueur de l'instance.The following example creates a LineString instance and uses STLength() to find the length of the instance.

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

 Voir aussiSee Also

Méthodes OGC sur des instances geographyOGC Methods on Geography Instances