geo_polygon_simplify()
Zjednodušuje mnohoúhelník nebo multipolygon nahrazením téměř rovných řetězců krátkých hran jediným dlouhým okrajem na Zemi.
Syntax
geo_polygon_simplify(
Mnohoúhelník,
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 maximální vzdálenost v metrech mezi původním planárním okrajem a převedeným geodetickým řetězcem okrajů. 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 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 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é 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 odebráním vrcholů, které jsou od sebe 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.796734763556572],[-73.94906312272477, 40.797107362717881],[-73.949236124753952, 40.7968708081794],[-73.948851227760315, 40.796734763556572]]]} |
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 z důvodu neplatného 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 |
---|
1 |
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 |
---|
1 |
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 |
---|
1 |
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro