STLength (tipo di dati geography)

  • Articolo

Si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure

Restituisce la lunghezza totale degli elementi in un'istanza geography o le istanze geography in una GeometryCollection.

Sintassi

  
.STLength ( )

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

Tipi restituiti

Tipo SQL Server restituito: float

Tipo CLR restituito: SqlDouble

Osservazioni:

Se un'istanza geography è chiusa, la lunghezza viene calcolata come lunghezza totale lungo l'istanza. La lunghezza di qualsiasi poligono è il relativo perimetro e la lunghezza di un punto è 0. La lunghezza di un oggetto GeometryCollection viene calcolata eseguendo la somma delle lunghezze di tutte le istanze geography contenute nella raccolta.

STLength() può essere utilizzato con oggetti LineString validi e non validi. In genere, un oggetto LineString non è valido a causa di segmenti sovrapposti dovuti ad anomalie, ad esempio tracce GPS imprecise. STLength() non rimuove i segmenti sovrapposti o non validi, i quali vengono inclusi nel valore di lunghezza restituito. È possibile rimuovere i segmenti sovrapposti da un oggetto LineString con il metodo MakeValid().

Esempi

Nell'esempio seguente viene creata un'istanza LineString e viene utilizzato STLength() per trovare la lunghezza dell'istanza.

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

Vedi anche

Metodi OGC sulle istanze di geografia