geo_union_lines_array()

  • Artikel

Berechnet die Vereinigung von Linien oder Mehrlinien auf der Erde.

Syntax

geo_union_lines_array(Linestrings)

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Typ Erforderlich BESCHREIBUNG
Linestrings dynamic ✔️ Ein Array von Linien oder mehrteiligen Linien im GeoJSON-Format.

Gibt zurück

Eine Linie oder eine mehrzeilige Linie im GeoJSON-Format und eines dynamischen Datentyps. Wenn eine der bereitgestellten Zeilen oder mehrzeiligen Zeilen ungültig ist, erzeugt die Abfrage ein NULL-Ergebnis.

Hinweis

  • Die Geokoordinaten werden durch das Koordinatenreferenzsystem WGS-84 dargestellt interpretiert.
  • Das geodätische Datum, das für Messungen auf der Erde verwendet wird, ist eine Kugel. Polygonränder sind geodätische Ränder auf der Kugel.
  • Wenn Eingabelinienränder gerade kartesische Linien sind, sollten Sie geo_line_densify() verwenden, um planare Kanten in Geodätik zu konvertieren.

LineString-Definition und -Einschränkungen

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

  • LineString-Koordinatenarray muss mindestens zwei Einträge enthalten.
  • Koordinaten [Längengrad, Breitengrad] müssen gültig sein, wenn der Längengrad eine reelle Zahl im Bereich [-180, +180] und breitengrad eine reelle Zahl im Bereich [-90, +90] ist.
  • Die Kantenlänge muss kleiner als 180 Grad sein. Der kürzeste Rand zwischen den beiden Scheitelpunkten wird ausgewählt.

Beispiele

Im folgenden Beispiel wird eine georäumliche Union für Zeilenzeilen ausgeführt.

Abfrage ausführen

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)

Ausgabe

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

Im folgenden Beispiel wird eine georäumliche Union für Zeilenspalten ausgeführt.

Abfrage ausführen

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)

Ausgabe

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

Im folgenden Beispiel wird True zurückgegeben, da eine der Zeilen ungültig ist.

Abfrage ausführen

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

Ausgabe

invalid_union
True