Partager via

geo_line_simplify()

  • Article

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

Simplifie une ligne ou un multiligne en remplaçant des chaînes presque droites de bords courts par un seul bord long sur Terre.

Syntaxe

geo_line_simplify(tolérance lineString, )

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
lineString dynamic ✔️ LineString ou MultiLineString au format GeoJSON.
tolerance int, long ou réel Définit la distance minimale en mètres entre deux sommets. Les valeurs prises en charge sont comprises dans la plage [0, ~7,800,000 mètres]. Si la valeur n’est pas spécifiée, la valeur par défaut 10 est utilisée.

Retours

Ligne simplifiée ou multiligne au format GeoJSON et d’un type de données dynamique , sans deux sommets avec une distance inférieure à la tolérance. Si la ligne ou la tolérance 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 mesurer la distance sur terre est une sphère. Les bords de ligne 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.
  • Si l’entrée est multiligne et contient plusieurs lignes, le résultat sera la simplification de l’union des lignes.
  • Une tolérance élevée peut entraîner la disparition d’une petite ligne.

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 simplifie la ligne en supprimant les sommets situés à une distance de 10 mètres entre eux.

let line = dynamic({"type":"LineString","coordinates":[[-73.97033169865608,40.789063020152824],[-73.97039607167244,40.78897975920816],[-73.9704617857933,40.78888837512432],[-73.97052884101868,40.7887949601531],[-73.9706052839756,40.788698498903564],[-73.97065222263336,40.78862640672032],[-73.97072866559029,40.78852791445617],[-73.97079303860664,40.788434498977836]]});
print simplified = geo_line_simplify(line, 10)

Sortie

simplified
{"type » : « LineString », « coordinates » : [[-73.97033169865608, 40.789063020152824], [-73.97079303038664, 40.788434498977836]]}

L’exemple suivant simplifie les lignes et combine les résultats dans la collection geometry GeoJSON.

NY_Manhattan_Roads
| project road = features.geometry
| project road_simplified = geo_line_simplify(road, 100)
| summarize roads_lst = make_list(road_simplified)
| project geojson = bag_pack("type", "Feature","geometry", bag_pack("type", "GeometryCollection", "geometries", roads_lst), "properties", bag_pack("name", "roads"))

Sortie

geojson
{"type » : « Feature », « geometry » : {"type » : « GeometryCollection », « geometries » : [ ... ]}, « properties » : {"name » : « roads"}}

L’exemple suivant simplifie les lignes et unifie le résultat

NY_Manhattan_Roads
| project road = features.geometry
| project road_simplified = geo_line_simplify(road, 100)
| summarize roads_lst = make_list(road_simplified)
| project roads = geo_union_lines_array(roads_lst)

Sortie

Routes
{"type » : « MultiLineString », « coordinates » : [ ... ]}

L’exemple suivant retourne True en raison de la ligne non valide.

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

Sortie

is_invalid_line
True

L’exemple suivant retourne True en raison de la tolérance non valide.

print is_invalid_line = isnull(geo_line_simplify(dynamic({"type":"LineString","coordinates":[[1, 1],[2,2]]}), -1))

Sortie

is_invalid_line
True

L’exemple suivant retourne True, car la tolérance élevée entraîne la disparition de petites lignes.

print is_invalid_line = isnull(geo_line_simplify(dynamic({"type":"LineString","coordinates":[[1.1, 1.1],[1.2,1.2]]}), 100000))

Sortie

is_invalid_line
True