Compartir a través de

geo_line_length()

  • Artículo

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Calcula la longitud total de una línea o una multilínea en la Tierra.

Sintaxis

geo_line_length(lineString)

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre Type Obligatorio Descripción
lineString dynamic ✔️ LineString o MultiLineString en formato GeoJSON.

Devoluciones

Longitud total de una línea o una línea múltiple, en metros, en la Tierra. Si la línea o multilínea no es válida, la consulta generará un resultado NULO.

Nota:

  • Las coordenadas geoespaciales se interpretan como representadas por el sistema de referencia de coordenadas WGS-84 .
  • El dato geodético utilizado para medir la distancia en la Tierra es una esfera. Los bordes de línea son geodesics en la esfera.
  • Si los bordes de línea de entrada son líneas cartesianas rectas, considere la posibilidad de usar geo_line_densify() para convertir bordes planar a geodesics.
  • Si la entrada es una línea múltiple y contiene más de una línea, el resultado será la longitud total de la unión de líneas.

Definición y restricciones 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 matriz de coordenadas LineString debe contener al menos dos entradas.
  • Las coordenadas [longitud, latitud] deben ser válidas donde la longitud es un número real en el intervalo [-180, +180] y la latitud es un número real en el intervalo [-90, +90].
  • La longitud del borde debe ser inferior a 180 grados. Se elegirá el borde más corto entre los dos vértices.

Ejemplos

En el ejemplo siguiente se calcula la longitud total de línea, en metros.

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

Salida

length
4922.48016992081

En el ejemplo siguiente se calcula la longitud total de varias líneas, en metros.

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)

Salida

length
8262.24339753741

En el ejemplo siguiente se devuelve True debido a la línea no válida.

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

Salida

is_bad_line
True