geo_union_lines_array()

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Calcule l’union des lignes ou des lignes multilignes sur Terre.

Syntaxe

geo_union_lines_array(lineStrings)

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom	Type	Requise	Description
lineStrings	dynamic	✔️	Tableau de lignes ou de lignes multiples au format GeoJSON.

Retours

Ligne ou multiligne au format GeoJSON et d’un type de données dynamique . Si l’une des lignes ou des lignes fournies n’est pas valide, la requête produit un résultat null.

Remarque

• Les coordonnées géospatiales sont interprétées comme représentées par le système de référence de coordonnées WGS-84 .
• La référence géodésique utilisée pour les mesures sur Terre est une sphère. Les bords de polygones sont géodésiques sur la sphère.
• Si les bords de ligne d’entrée sont des lignes cartésiennes droites, envisagez d’utiliser geo_line_densify() pour convertir les bords planaires en géodésiques.

Définition et contraintes 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]})

• Le tableau de coordonnées LineString doit contenir au moins deux entrées.
• Les coordonnées [longitude, latitude] doivent être valides, où la longitude est un nombre réel dans la plage [-180, +180] et la latitude est un nombre réel dans la plage [-90, +90].
• La longueur du bord doit être inférieure à 180 degrés. Le bord le plus court entre les deux sommets sera choisi.

Exemples

L’exemple suivant effectue une union géospatiale sur les lignes de ligne.

Exécuter la requête

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)

Sortie

lines_union
{"type » : « LineString », « coordinates » : [[-73.956838846206651, 40.805028914808844], [-73.95633727312088, 40.805717171177], [ -73.954891562461853, 40.80510200431312], [-73.9553743360084534, 40.80441374162452]]] }

L’exemple suivant effectue une union géospatiale sur les colonnes de ligne.

Exécuter la requête

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)

Sortie

lines_union
{"type » : « LineString », « coordinates » :[-73.956838846206651, 40.805028914808844], [-73.95633727312088, 40.805717171177], [-73.954891562461853, 40.80510200431312], [-73.9553743360084534, 40.8041374162452]]}

L’exemple suivant retourne True, car l’une des lignes n’est pas valide.

Exécuter la requête

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

Sortie

invalid_union
True