ST_Length

PDFRSS

Per una geometria lineare, ST_Length restituisce la lunghezza cartesiana di una proiezione 2D. Le unità di lunghezza sono le stesse delle unità in cui sono espresse le coordinate della geometria di input. La funzione restituisce zero (0) per punti, multipunti e geometrie areali. Quando l'input è una raccolta di geometrie, la funzione restituisce la somma delle lunghezze delle geometrie nella raccolta.

Per una geografia, ST_Length restituisce la lunghezza geodetica della proiezione 2D di una geografia lineare di input calcolata sullo sferoide determinato dallo SRID. L'unità di lunghezza è espressa in metri. La funzione restituisce zero (0) per punti, multipunti e geografie areali. Quando l'input è una raccolta di geometrie, la funzione restituisce la somma delle lunghezze delle geografie nella raccolta.

Sintassi

ST_Length(geo)

Argomenti

geo

Un valore di tipo GEOMETRY o GEOGRAPHY o un'espressione che restituisce un valore di tipo GEOMETRY o GEOGRAPHY.

Tipo restituito

DOUBLE PRECISION

Se geo è nullo, allora viene restituito il valore nullo.

Se il valore SRID non viene trovato, allora viene restituito un errore.

Esempi

Il seguente codice SQL restituisce la lunghezza cartesiana di una multilinestring.

SELECT ST_Length(ST_GeomFromText('MULTILINESTRING((0 0,10 0,0 10),(10 0,20 0,20 10))'));

st_length
--------------------------------
  44.142135623731

Il seguente SQL restituisce la lunghezza di una linestring in una geografia.

SELECT ST_Length(ST_GeogFromText('SRID=4326;LINESTRING(5 0,6 0,4 0)'));

 st_length 
------------------
 333958.472379804

Il seguente SQL restituisce la lunghezza di un punto in una geografia

SELECT ST_Length(ST_GeogFromText('SRID=4326;POINT(4 5)'));

 st_length 
-----------
 0