geo_union_lines_array()

  • Articolo

Calcola l'unione di linee o multilinee sulla Terra.

Sintassi

geo_union_lines_array(lineStrings)

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Tipo Obbligatoria Descrizione
lineStrings dynamic ✔️ Matrice di righe o multilinee nel formato GeoJSON.

Restituisce

Riga o multilinea in formato GeoJSON e di un tipo di dati dinamico . Se una delle righe o delle righe specificate non è valida, la query genererà un risultato Null.

Nota

  • Le coordinate geospaziali vengono interpretate come rappresentate dal sistema di riferimento delle coordinate WGS-84 .
  • Il datum geodetico usato per le misurazioni sulla Terra è una sfera. I bordi del poligono 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.

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 quando la longitudine è un numero reale nell'intervallo [-180, +180] e la latitudine è un numero reale nell'intervallo [-90, +90].
  • La lunghezza dei bordi deve essere inferiore a 180 gradi. Verrà scelto il bordo più corto tra i due vertici.

Esempio

Nell'esempio seguente viene eseguita l'unione geospaziale nelle righe di riga.

Eseguire la query

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)

Output

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

Nell'esempio seguente viene eseguita l'unione geospaziale sulle colonne di riga.

Eseguire la query

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)

Output

lines_union
{"type": "LineString", "coordinates":[-73.95683846206651, 40.80502891480844], [-73.95633727312088, 40.8057171711177], [-73.954891562461853, 40.8051020431312], [-73.955374360084534, 40.804413741624522]]}

Nell'esempio seguente viene restituito True perché una delle righe non è valida.

Eseguire la query

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))

Output

invalid_union
True