Share via

geo_union_lines_array()

  • Artículo

Calcula la unión de líneas o varias líneas en la Tierra.

Syntax

geo_union_lines_array(lineStrings)

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

Parámetros

Nombre Tipo Requerido Descripción
lineStrings dynamic ✔️ Matriz de líneas o multilíneas en formato GeoJSON.

Devoluciones

Línea o multilínea en formato GeoJSON y de un tipo de datos dinámico . Si alguna de las líneas o varias líneas proporcionadas 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 .
  • La referencia geodética utilizada para las mediciones en la Tierra es una esfera. Los bordes de polígono son geodesics en la esfera.
  • Si los bordes de la línea de entrada son líneas cartesianas rectas, considere la posibilidad de usar geo_line_densify() para convertir los bordes planales en geodesics.

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 realiza la unión geoespacial en filas de línea.

Ejecución de la consulta

datatable(lines:dynamic)
[
    dynamic({"type":"LineString","coordinates":[[-73.95683884620665,40.80502891480884],[-73.95633727312088,40.8057171711177],[-73.95489156246185,40.80510200431311]]}),
    dynamic({"type":"LineString","coordinates":[[-73.95633727312088,40.8057171711177],[-73.95489156246185,40.80510200431311],[-73.95537436008453,40.804413741624515]]}),
    dynamic({"type":"LineString","coordinates":[[-73.95633727312088,40.8057171711177],[-73.95489156246185,40.80510200431311]]})
]
| summarize lines_arr = make_list(lines)
| project lines_union = geo_union_lines_array(lines_arr)

Salida

lines_union
{"type": "LineString", "coordinates": [-73.956838846206651, 40.805028914808844], [-73.95633727312088, 40.805717171177], [ -73.954891562461853, 40.80510200431312], [-73.955374360084534, 40.804413741624522]]}

En el ejemplo siguiente se realiza la unión geoespacial en las columnas de línea.

Ejecución de la consulta

datatable(line1:dynamic, line2:dynamic)
[
    dynamic({"type":"LineString","coordinates":[[-73.95683884620665,40.80502891480884],[-73.95633727312088,40.8057171711177],[-73.95489156246185,40.80510200431311]]}), dynamic({"type":"LineString","coordinates":[[-73.95633727312088,40.8057171711177],[-73.95489156246185,40.80510200431311],[-73.95537436008453,40.804413741624515]]})
]
| project lines_arr = pack_array(line1, line2)
| project lines_union = geo_union_lines_array(lines_arr)

Salida

lines_union
{"type": "LineString", "coordinates":[[-73.956838846206651, 40.80502891480844], [-73.95633727312088, 40.805717171177], [-73.954891562461853, 40.80510200431312], [-73.955374360084534, 40.804413741624522]]}

En el ejemplo siguiente se devuelve True porque una de las líneas no es válida.

Ejecución de la consulta

datatable(lines:dynamic)
[
    dynamic({"type":"LineString","coordinates":[[-73.95683884620665,40.80502891480884],[-73.95633727312088,40.8057171711177],[-73.95489156246185,40.80510200431311]]}),
    dynamic({"type":"LineString","coordinates":[[1, 1]]})
]
| summarize lines_arr = make_list(lines)
| project invalid_union = isnull(geo_union_lines_array(lines_arr))

Salida

invalid_union
True