geo_line_length()

  • Articolo

Calcola la lunghezza totale di una linea o una multilinea sulla Terra.

Sintassi

geo_line_length(Linestring)

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Tipo Obbligatoria Descrizione
Linestring dynamic ✔️ LineString o MultiLineString nel formato GeoJSON.

Restituisce

Lunghezza totale di una linea o di una multilinea, in metri, sulla Terra. Se la riga o la multilinea non è valida, la query genererà un risultato Null.

Nota

  • Le coordinate geospaziali vengono interpretate come rappresentate dal sistema di riferimento di coordinate WGS-84 .
  • Il datum geodetico usato per misurare la distanza sulla Terra è una sfera. I bordi linea sono geodesici sulla sfera.
  • Se i bordi della linea di input sono linee cartesiane dritte, è consigliabile usare geo_line_densify() per convertire i bordi planari in geodesici.
  • Se l'input è una linea multipla e contiene più righe, il risultato sarà la lunghezza totale dell'unione delle righe.

Definizione e vincoli LineString

dynamic({"type": "LineString","coordinates": [[lng_1,lat_1], [lng_2,lat_2], ..., [lng_N,lat_N]]))

dynamic({"type": "MultiLineString","coordinates": [[line_1, line_2, ..., line_N]]})

  • La matrice di coordinate LineString deve contenere almeno due voci.
  • Le coordinate [longitudine, latitudine] devono essere valide dove la longitudine è un numero reale nell'intervallo [-180, +180] e latitudine è un numero reale nell'intervallo [-90, +90].
  • La lunghezza del bordo deve essere inferiore a 180 gradi. Il bordo più corto tra i due vertici verrà scelto.

Esempio

Nell'esempio seguente viene calcolata la lunghezza totale della linea, in metri.

Eseguire la query

let line = dynamic({"type":"LineString","coordinates":[[-73.95807266235352,40.800426144169315],[-73.94966125488281,40.79691751000055],[-73.97317886352539,40.764486356930334]]});
print length = geo_line_length(line)

Output

length
4922.48016992081

Nell'esempio seguente viene calcolata la lunghezza totale multilinea, in metri.

Eseguire la query

let line = dynamic({"type":"MultiLineString","coordinates":[[[-73.95798683166502,40.800556090021466],[-73.98193359375,40.76819171855746]],[[-73.94940376281738,40.79691751000055],[-73.97317886352539,40.76435634049001]]]});
print length = geo_line_length(line)

Output

length
8262.24339753741

L'esempio seguente restituisce True a causa della riga non valida.

Eseguire la query

print is_bad_line = isnull(geo_line_length(dynamic({"type":"LineString","coordinates":[[1, 1]]})))

Output

is_bad_line
True