geo_union_polygons_array()

Vypočítá spojení mnohoúhelníků nebo multipolygonů na Zemi.

Syntax

geo_union_polygons_array(Mnohoúhelníky)

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

Parametry

Název	Typ	Vyžadováno	Popis
Mnohoúhelníky	dynamic	✔️	Pole mnohoúhelníků nebo multipolygonů ve formátu GeoJSON.

Návraty

Mnohoúhelník nebo multipolygon ve formátu GeoJSON a dynamického datového typu. Pokud je některý ze zadaných mnohoúhelníků nebo multipolygonů neplatný, dotaz vygeneruje výsledek null.

Poznámka

• Geoprostorové souřadnice jsou interpretovány jako reprezentované systémem souřadnic WGS-84 .
• Geodetické datum 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.

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 counterclockwise uspořádané pole 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 nejméně 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 rozsahu [-180, +180] a zeměpisná šířka musí být reálné číslo v rozsahu [-90, +90].
• LinearRingShell obklopuje nejvýše polovinu sféry. LinearRing rozdělí kouli do dvou oblastí. Zvolí se menší z těchto dvou oblastí.
• Délka hrany linearRing musí být menší než 180 stupňů. Zvolí se nejkratší hrana mezi těmito dvěma vrcholy.
• LinearRings se nesmí křížovat a nesmí sdílet hrany. LinearRings může sdílet vrcholy.

Příklady

Následující příklad provádí geoprostorové sjednocení na řádcích mnohoúhelníku.

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 polygons_arr = make_list(polygons)
| project polygons_union = geo_union_polygons_array(polygons_arr)

Výstup

polygons_union

{"type":"Polygon","coordinates":[[[-73.972599326729608,40.765330371902991],[-73.960302383706178,40.782140794645024],[-73.9577,40.7789],[-73.94622,40.79249],[-73.9526593223173,40.792584227716468],[-73.9495,40.7969],[-73.95807,40.80068],[-73.9639277517478,40.792748258673875],[-73.96888,40.792819999999992],[-73.9662719791645,40.7895734224338],[-73.9803360309571,40.770518810606404],[-73.9936,40.7663],[-73.97171,40.756550000000004],[- 73.972599326729608,40.765330371902991]]]}

Následující příklad provádí geoprostorové sjednocení u mnohoúhelníkových sloupců.

Spuštění dotazu

datatable(polygon1:dynamic, polygon2: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]]]})
]
| project polygons_arr = pack_array(polygon1, polygon2)
| project polygons_union = geo_union_polygons_array(polygons_arr)

Výstup

polygons_union
{"type":"Mnohoúhelník","souřadnice":[[[-73.9495,40,7969],[-73,95807,40,80068],[-73,9639277517478,40,792748258673875],[-73.96888,40.79281999999992],[-73.9662719791645,40.7895734224338],[-73.98201,1 40.76825],[-73.97317,40.76455],[-73.960302383706178,40.782140794645024],[-73.9577,40.7789],[-73.94622,40.79249],[-73.9526593223173,40.79258427716468],[-73.9495,40.7969]]]}

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]]]})
]
| summarize polygons_arr = make_list(polygons)
| project invalid_union = isnull(geo_union_polygons_array(polygons_arr))

Výstup

invalid_union
Ano