geo_polygon_simplify()

  • Artykuł

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

Składnia

geo_polygon_simplify(Wielokąt,Tolerancji)

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

Parametry

Nazwa Typ Wymagane Opis
Wielokąt dynamic ✔️ Wielokąt lub multipolygon w formacie GeoJSON.
Tolerancji 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 zostanie określona, 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 spowoduje wygenerowanie wyniku null.

Uwaga

  • Jeśli dane wejściowe mają więcej niż jeden wielokąt, z obramowaniami wzajemnymi, 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 to geodesy na sferze.
  • Jeśli krawędzie wielokąta wejściowe są liniami kartezjańskimi, rozważ użycie geo_polygon_densify(), aby przekonwertować krawędzie planarne na geodesy.
  • Jeśli dane wejściowe to wielokąt i zawiera 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ąta

dynamic({"type": "Polygon","współrzędne": [ 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 counterclockwise tablica współrzędnych [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Może istnieć tylko jedna powłoka.
  • LinearRingHole jest opcjonalny i zdefiniowany jako uporządkowana clockwise tablica współrzędnych [[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ć różne 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] i 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. Zostanie wybrana mniejsza 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.
  • Linijki nie mogą przekraczać i nie mogą udostępniać krawędzi. Wierzchołki liniowe mogą udostępniać 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.

Uruchamianie zapytania

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)

Dane wyjściowe

Uproszczony
{"type": "Polygon", "coordinates": [[-73.94885122760315, 40.79673476565572],[-73.94906312227272477, 40.797107362717881],[-73.949236124753952, 40.796870888081794],[-73.94885122760315, 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"))

Dane wyjściowe

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

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

Uruchamianie zapytania

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)

Dane wyjściowe

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

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

Uruchamianie zapytania

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

Dane wyjściowe

is_invalid_polygon
1

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

Uruchamianie zapytania

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

Dane wyjściowe

is_invalid_polygon
1

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

Uruchamianie zapytania

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

Dane wyjściowe

is_invalid_polygon
1