Udostępnij za pośrednictwem

geo_line_simplify()

  • Artykuł

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Upraszcza linię lub wielowierszową, zastępując prawie proste łańcuchy krótkich krawędzi pojedynczą długą krawędzią na Ziemi.

Składnia

geo_line_simplify(tolerancja lineString, )

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
lineString dynamic ✔️ Ciąg lineString lub MultiLineString w formacie GeoJSON.
tolerancja int, long lub real Definiuje minimalną odległość w metrach między dowolnymi dwoma wierzchołkami. Obsługiwane wartości znajdują się w zakresie [0, ~7 800 000 metrów]. Jeśli nie określono, zostanie użyta wartość 10 domyślna.

Zwraca

Uproszczony wiersz lub wielowierszowy w formacie GeoJSON i typu danych dynamicznych , bez dwóch wierzchołków o odległości mniejszej niż tolerancja. Jeśli wiersz lub tolerancja jest nieprawidłowa, zapytanie spowoduje wygenerowanie wyniku o wartości null.

Uwaga

  • Współrzędne geoprzestrzenne są interpretowane jako reprezentowane przez system odniesienia współrzędnych WGS-84 .
  • Geodetyczne datum używane do mierzenia odległości na Ziemi jest sferą. Krawędzie linii są geodesykami na sferze.
  • Jeśli krawędzie linii wejściowej są liniami kartezjańskimi, rozważ użycie geo_line_densify() w celu przekonwertowania krawędzi planarnych na geodesiki.
  • Jeśli dane wejściowe są wielowierszowe i zawierają więcej niż jeden wiersz, wynikiem będzie uproszczenie unii wierszy.
  • Wysoka tolerancja może spowodować zniknięcie małej linii.

Definicja i ograniczenia linestring

dynamic({"type": "LineString","coordinates": [[lng_1,lat_1], [lng_2,lat_2], ..., [lng_N,lat_N]]})

dynamic({"type": "MultiLineString","współrzędne": [[line_1, line_2, ..., line_N]]})

  • Tablica współrzędnych LineString musi zawierać co najmniej dwa wpisy.
  • Współrzędne [długość geograficzna, szerokość geograficzna] muszą być prawidłowe, gdzie długość geograficzna jest liczbą rzeczywistą w zakresie [-180, +180], a szerokość geograficzna jest liczbą rzeczywistą w zakresie [-90, +90].
  • Długość krawędzi musi być mniejsza niż 180 stopni. Zostanie wybrana najkrótsza krawędź między dwoma wierzchołkami.

Przykłady

Poniższy przykład upraszcza linię, usuwając wierzchołki znajdujące się w odległości 10 metrów od siebie.

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)

Wyjście

Uproszczony
{"type": "LineString", "coordinates": [[-73.97033169865608, 40.78906302020152824], [-73.970793030380664, 40.788434987836]}

Poniższy przykład upraszcza linie i łączy wyniki w kolekcji geometrii 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"))

Wyjście

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

Poniższy przykład upraszcza wiersze i unifies wynik

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)

Wyjście

Drogi
{"type": "MultiLineString", "współrzędne": [ ... ]}

Poniższy przykład zwraca wartość True z powodu nieprawidłowego wiersza.

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

Wyjście

is_invalid_line
Prawda

Poniższy przykład zwraca wartość True z powodu nieprawidłowej tolerancji.

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

Wyjście

is_invalid_line
Prawda

Poniższy przykład zwraca wartość True, ponieważ wysoka tolerancja powoduje zniknięcie małej linii.

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

Wyjście

is_invalid_line
Prawda