geo_line_simplify()

  • Artykuł

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

Składnia

geo_line_simplify(Linestring,Tolerancji)

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa Typ Wymagane Opis
Linestring dynamic ✔️ Ciąg lineString lub MultiLineString w formacie GeoJSON.
Tolerancji int, long, or 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 zostanie określona, 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 zwróci wynik o wartości null.

Uwaga

  • Współrzędne geoprzestrzenne są interpretowane jako reprezentowane przez system odniesienia współrzędnych WGS-84 .
  • Dataum geodetyczne 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ą prostymi liniami kartezjańskimi, rozważ użycie geo_line_densify(), aby przekonwertować krawędzie planarne na geodesyki.
  • 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, gdy 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.

Uruchamianie zapytania

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)

Dane wyjściowe

Uproszczony
{"type": "LineString", "coordinates": [[-73.97033169865608, 40.789063020202824], [-73.9707930386064, 40.7884344987836]}

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

Dane wyjściowe

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)

Dane wyjściowe

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

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

Uruchamianie zapytania

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

Dane wyjściowe

is_invalid_line
Prawda

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

Uruchamianie zapytania

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

Dane wyjściowe

is_invalid_line
Prawda

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

Uruchamianie zapytania

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

Dane wyjściowe

is_invalid_line
Prawda