Sdílet prostřednictvím

geo_polygon_simplify()

  • Článek

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Zjednodušuje mnohoúhelník nebo multipolygon nahrazením téměř rovných řetězců krátkých hran jedním dlouhým okrajem na Zemi.

Syntaxe

geo_polygon_simplify(tolerance mnohoúhelníku, )

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název Type Požadováno Popis
mnohoúhelník dynamic ✔️ Mnohoúhelník nebo multipolygon ve formátu GeoJSON.
tolerance int, long nebo real Definuje maximální vzdálenost v metrech mezi původním planárním okrajem a převedeným geodesickým hraničním řetězcem. Podporované hodnoty jsou v rozsahu [0,1, 10000]. Pokud není zadáno, výchozí hodnota je 10.

Návraty

Zjednodušený mnohoúhelník nebo multipolygon ve formátu GeoJSON a dynamického datového typu bez dvou vrcholů s menší vzdáleností než tolerance. Pokud je mnohoúhelník nebo tolerance neplatný, dotaz vytvoří výsledek null.

Poznámka:

  • Pokud má vstup více než jeden mnohoúhelník se vzájemnými ohraničeními, přečtěte si geo_simplify_polygons_array().
  • Geoprostorové souřadnice jsou interpretovány jako reprezentované referenčním systémem souřadnic WGS-84 .
  • Geodetické datum používané pro měření na Zemi je sféra. Polygonové hrany jsou geodesické oblasti na kouli.
  • Pokud jsou vstupní mnohoúhelníky rovné kartézské čáry, zvažte použití geo_polygon_densify() k převodu planárních hran na geodesické čáry.
  • Pokud je vstup multipolygon a obsahuje více než jeden mnohoúhelník, výsledkem bude oblast mnohoúhelníku sjednocení.
  • Vysoká tolerance může způsobit, že malý mnohoúhelník zmizí.

Definice mnohoúhelníku a omezení

dynamic({"type": "Mnohoúhelník";"souřadnice": [ LinearRingShell, LinearRingHole_1; ..., LinearRingHole_N ]})

dynamic({"type": "MultiPolygon";"souřadnice": [[ LinearRingShell, LinearRingHole_1; ..., LinearRingHole_N ], ..., [LinearRingShell, LinearRingHole_1; ..., LinearRingHole_M]]})

  • LinearRingShell je povinný a definovaný jako seřazená counterclockwise matice souřadnic [[lng_1;lat_1],...,[lng_i;lat_i],...,[lng_j;lat_j],...,[lng_1;lat_1]]. Může existovat pouze jedno prostředí.
  • LinearRingHole je volitelný a definovaný jako clockwise uspořádané pole souřadnic [[lng_1;lat_1],...,[lng_i;lat_i],...,[lng_j;lat_j],...,[lng_1;lat_1]]. Může existovat libovolný počet vnitřních kroužků a otvorů.
  • Vrcholy linearring musí být odlišné s alespoň třemi souřadnicemi. První souřadnice musí být rovna poslední. Vyžaduje se aspoň čtyři položky.
  • Souřadnice [zeměpisná délka, zeměpisná šířka] musí být platné. Zeměpisná délka musí být reálné číslo v oblasti [-180, +180] a zeměpisná šířka musí být reálné číslo v oblasti [-90, +90].
  • LinearRingShell uzavře většinu poloviny sféry. LinearRing rozdělí sféru do dvou oblastí. Zvolí se menší ze dvou oblastí.
  • Délka hrany linearring musí být menší než 180 stupňů. Vybere se nejkratší hrana mezi dvěma vrcholy.
  • LinearRings nesmí křížovat a nesmí sdílet hrany. LinearRings může sdílet vrcholy.

Příklady

Následující příklad zjednodušuje mnohoúhelníky odebráním vrcholů, které jsou mezi sebou vzdáleny 10 metrů.

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)

Výstup

zjednodušený
{"type": "Mnohoúhelník", "souřadnice": [[-73.948851227760315, 40.7967347656572],[-73.94906312227272477, 40.797107362717881],[-73.949236124753952, 40.7968708081794],[-73.94885127760315, 40.79673476356572]]]}

Následující příklad zjednodušuje mnohoúhelníky a kombinuje výsledky do kolekce geometrie 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"))

Výstup

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

Následující příklad zjednodušuje mnohoúhelníky a sjednocuje výsledek.

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)

Výstup

mnohoúhelníky
{"type": "MultiPolygon", "coordinates": [ ... ]}

Následující příklad vrátí hodnotu True kvůli neplatnému mnohoúhelníku.

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

Výstup

is_invalid_polygon
0

Následující příklad vrátí hodnotu True z důvodu neplatné tolerance.

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

Výstup

is_invalid_polygon
0

Následující příklad vrátí hodnotu True, protože vysoká tolerance způsobí, že mnohoúhelník zmizí.

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

Výstup

is_invalid_polygon
0