Udostępnij za pośrednictwem

geo_polygon_simplify()

  • Artykuł

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

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

Składnia

geo_polygon_simplify(tolerancja wielokątna, )

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

Parametry

Nazwisko Type Wymagania opis
wielokąt dynamic ✔️ Wielokąt lub multipolygon w formacie GeoJSON.
tolerancja int, long lub real Definiuje maksymalną odległość w metrach między oryginalną krawędzią planarną a przekształconym łańcuchem krawędzi geodesowych. Obsługiwane wartości znajdują się w zakresie [0.1, 10000]. Jeśli nie określono, wartość domyślna to 10.

Zwraca

Uproszczony wielokąt lub multipolygon w formacie GeoJSON i dynamiczny typ danych bez dwóch wierzchołków o odległości mniejszej niż tolerancja. Jeśli wielokąt lub tolerancja jest nieprawidłowa, zapytanie zwróci wynik o wartości null.

Uwaga

  • Jeśli dane wejściowe mają więcej niż jeden wielokąt z obramowaniem wzajemnym, zobacz geo_simplify_polygons_array().
  • Współrzędne geoprzestrzenne są interpretowane jako reprezentowane przez system odniesienia współrzędnych WGS-84 .
  • Geodetyczne datum używane do pomiarów na Ziemi jest sferą. Krawędzie wielokątne są geodesykami na sferze.
  • Jeśli krawędzie wielokąta wejściowe są liniami kartezjańskimi, rozważ użycie geo_polygon_densify() w celu przekonwertowania krawędzi planarnych na geodesyki.
  • Jeśli dane wejściowe są wielokątne i zawierają więcej niż jeden wielokąt, wynik będzie obszarem unii wielokątów.
  • Wysoka tolerancja może spowodować zniknięcie małego wielokąta.

Definicja i ograniczenia wielokątne

dynamic({"type": "Polygon","coordinates": [ LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N ]})

dynamic({"type": "MultiPolygon","współrzędne": [[ LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N ], ..., [LinearRingShell, LinearRingHole_1, ..., LinearRingHole_M]]})

  • Program LinearRingShell jest wymagany i zdefiniowany jako uporządkowana tablica współrzędnych counterclockwise [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Może istnieć tylko jedna powłoka.
  • Funkcja LinearRingHole jest opcjonalna i zdefiniowana jako uporządkowana tablica współrzędnych clockwise [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Może istnieć dowolna liczba pierścieni i otworów wewnętrznych.
  • Wierzchołki liniowe muszą być odrębne z co najmniej trzema współrzędnymi. Pierwsza współrzędna musi być równa ostatniej. Wymagane są co najmniej cztery wpisy.
  • Współrzędne [długość geograficzna, szerokość geograficzna] muszą być prawidłowe. Długość geograficzna musi być liczbą rzeczywistą w zakresie [-180, +180], a szerokość geograficzna musi być liczbą rzeczywistą w zakresie [-90, +90].
  • LinearRingShell otacza co najwyżej połowę kuli. Funkcja LinearRing dzieli sferę na dwa regiony. Zostaną wybrane mniejsze z dwóch regionów.
  • Długość krawędzi liniowej musi być mniejsza niż 180 stopni. Zostanie wybrana najkrótsza krawędź między dwoma wierzchołkami.
  • Wyrażenia liniowe nie mogą być krzyżowe i nie mogą współużytkować krawędzi. LinearRingi mogą współdzielić wierzchołki.

Przykłady

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

let polygon = dynamic({"type":"Polygon","coordinates":[[[-73.94885122776031,40.79673476355657],[-73.94885927438736,40.79692258628347],[-73.94887939095497,40.79692055577034],[-73.9488673210144,40.79693476936093],[-73.94888743758202,40.79693476936093],[-73.9488834142685,40.796959135509105],[-73.94890084862709,40.79695304397289],[-73.94906312227248,40.79710736271788],[-73.94923612475395,40.7968708081794],[-73.94885122776031,40.79673476355657]]]});
print simplified = geo_polygon_simplify(polygon)

Wyjście

Uproszczony
{"type": "Polygon", "coordinates": [[[-73.94885122760315, 40.796734763565572],[-73.94906312227272477, 40.797107362717881],[-73.949236124753952, 40.79687088081794],[-73.948851227760315, 40.796734763556572]]]}

Poniższy przykład upraszcza wielokąty i łączy wyniki w kolekcji geometrii GeoJSON.

Polygons
| project polygon = features.geometry
| project simplified = geo_polygon_simplify(polygon, 1000)
| summarize lst = make_list(simplified)
| project geojson = bag_pack("type", "Feature","geometry", bag_pack("type", "GeometryCollection", "geometries", lst), "properties", bag_pack("name", "polygons"))

Wyjście

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

Poniższy przykład upraszcza wielokąty i unifies wynik

US_States
| project polygon = features.geometry
| project simplified = geo_polygon_simplify(polygon, 1000)
| summarize lst = make_list(simplified)
| project polygons = geo_union_polygons_array(lst)

Wyjście

Wielokątów
{"type": "MultiPolygon", "współrzędne": [ ... ]}

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

let polygon = dynamic({"type":"Polygon","coordinates":[[[5,48],[5,48]]]});
print is_invalid_polygon = isnull(geo_polygon_simplify(polygon))

Wyjście

is_invalid_polygon
1

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

let polygon = dynamic({"type":"Polygon","coordinates":[[[5,48],[0,50],[0,47],[4,47],[5,48]]]});
print is_invalid_polygon = isnull(geo_polygon_simplify(polygon, -0.1))

Wyjście

is_invalid_polygon
1

Poniższy przykład zwraca wartość True, ponieważ wysoka tolerancja powoduje zniknięcie wielokąta.

let polygon = dynamic({"type":"Polygon","coordinates":[[[5,48],[0,50],[0,47],[4,47],[5,48]]]});
print is_invalid_polygon = isnull(geo_polygon_simplify(polygon, 1000000))

Wyjście

is_invalid_polygon
1