geo_simplify_polygons_array()

Zjednodušuje mnohoúhelníky nahrazením téměř rovných řetězů krátkých hran jednou dlouhou hranou na Zemi.

Syntax

geo_simplify_polygons_array(Mnohoúhelníky,Tolerance)

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

Parametry

Název	Typ	Vyžadováno	Popis
Mnohoúhelník	dynamic	✔️	Mnohoúhelník nebo multipolygon ve formátu GeoJSON.
Tolerance	int, long nebo real		Definuje minimální vzdálenost v metrech mezi libovolnými dvěma vrcholy. Podporované hodnoty jsou v rozsahu [0, ~7 800 000 metrů]. Pokud není zadáno, použije se výchozí hodnota 10 .

Návraty

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

Poznámka

• Pokud je vstup jedním mnohoúhelníkem, přečtěte si geo_polygon_simplify().
• Geoprostorové souřadnice jsou interpretovány jako reprezentované systémem souřadnic WGS-84 .
• Geodetická rovina používaná pro měření na Zemi je koule. Mnohoúhelníkové hrany jsou geodézie na kouli.
• Pokud jsou vstupní mnohoúhelníky rovné kartézské čáry, zvažte použití geo_polygon_densify() k převodu rovinných okrajů na geodézie.
• Pokud je vstup multipolygon a obsahuje více než jeden mnohoúhelník, výsledkem bude sjednocení oblasti mnohoúhelníku.
• Vysoká tolerance může způsobit zmizení malého mnohoúhelníku.

Definice a omezení mnohoúhelníku

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

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

• LinearRingShell je povinný a definovaný jako uspořádané counterclockwise pole souřadnic [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Může existovat jenom jedno prostředí.
• LinearRingHole je nepovinný 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é alespoň třemi souřadnicemi. První souřadnice musí být rovna poslední. Vyžadují se alespoň č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 rozsahu [-90, +90].
• LinearRingShell obklopuje maximálně polovinu koule. LinearRing rozdělí kouli na dvě oblasti. Zvolí se menší z těchto dvou oblastí.
• Délka lineárního okraje musí být menší než 180 stupňů. Zvolí se nejkratší hrana mezi dvěma vrcholy.
• LinearRings nesmí křížovat a nesmí sdílet hrany. LinearRings mohou sdílet vrcholy.

Příklady

Následující příklad zjednodušuje mnohoúhelníky se vzájemnými ohraničeními (státy USA) odebráním vrcholů, které jsou od sebe vzdáleny 100 metrů.

Spuštění dotazu

US_States
| project polygon = features.geometry
| summarize lst = make_list(polygon)
| project polygons = geo_simplify_polygons_array(lst, 100)

Výstup

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

Následující příklad vrátí hodnotu True, protože jeden z mnohoúhelníků je neplatný.

Spuštění dotazu

datatable(polygons:dynamic)
[
    dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807,40.80068],[-73.98201,40.76825],[-73.97317,40.76455],[-73.9495,40.7969]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.94622,40.79249]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.97335,40.77274],[-73.9936,40.76630],[-73.97171,40.75655],[-73.97335,40.77274]]]})
]
| summarize arr = make_list(polygons)
| project is_invalid_polygon = isnull(geo_simplify_polygons_array(arr))

Výstup

is_invalid_polygon
1

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

Spuštění dotazu

datatable(polygons:dynamic)
[
    dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807,40.80068],[-73.98201,40.76825],[-73.97317,40.76455],[-73.9495,40.7969]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.94622,40.79249],[-73.96888,40.79282],[-73.9577,40.7789],[-73.94622,40.79249]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.97335,40.77274],[-73.9936,40.76630],[-73.97171,40.75655],[-73.97335,40.77274]]]})
]
| summarize arr = make_list(polygons)
| project is_null = isnull(geo_simplify_polygons_array(arr, -1))

Výstup

is_null
1

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

Spuštění dotazu

datatable(polygons:dynamic)
[
    dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807,40.80068],[-73.98201,40.76825],[-73.97317,40.76455],[-73.9495,40.7969]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.94622,40.79249],[-73.96888,40.79282],[-73.9577,40.7789],[-73.94622,40.79249]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.97335,40.77274],[-73.9936,40.76630],[-73.97171,40.75655],[-73.97335,40.77274]]]})
]
| summarize arr = make_list(polygons)
| project is_null = isnull(geo_simplify_polygons_array(arr, 10000))

Výstup

is_null
1