geo_union_polygons_array()

計算在地球上的多邊形或 Multipolygon 聯集。

Syntax

geo_union_polygons_array(多邊形)

深入瞭解 語法慣例。

參數

名稱	類型	必要	Description
多邊形	dynamic	✔️	GeoJSON 格式的多邊形或多多邊形陣列。

傳回

GeoJSON 格式和動態數據類型的多邊形或多多邊形。 如果任何提供的多邊形或多多邊形無效，查詢將會產生 Null 結果。

注意

• 地理空間座標會以 WGS-84 座標參考系統的表示來解讀。
• 用來測量地球的測量基準是球體。 多邊形邊緣是球體上的測地線。
• 如果輸入多邊形邊緣是直笛卡兒線，請考慮使用 geo_polygon_densify()，以將平面邊緣轉換為測地線。

多邊形定義和條件約束

dynamic ({“type”： “Polygon”，“coordinates”： [ LinearRingShell， LinearRingHole_1， ...， LinearRingHole_N ]})

dynamic ({“type”： “MultiPolygon”，“coordinates”： [[ LinearRingShell， LinearRingHole_1， ...， LinearRingHole_N]， ...， [LinearRingShell， LinearRingHole_1， ...， LinearRingHole_M]]})

• LinearRingShell 是必要條件，且會定義為座標[[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]] 的 counterclockwise 已排序陣列。 只能有一個殼層。
• LinearRingHole 是選擇性條件，且會定義為座標 [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]] 的 clockwise 已排序陣列。 可以有任意數目的內部通道和漏洞。
• LinearRing 頂點必須與至少三個座標不同。 第一個座標必須等於最後一個座標。 至少需要四個輸入項。
• 坐標 [經度，緯度] 必須有效。 經度必須是範圍 [-180，+180] 內的實數，且緯度必須是範圍 [-90，+90] 內的實數。
• LinearRingShell 最多會在球體的一半內。 LinearRing 會將球體分割成兩個區域。 將選擇兩個區域中較小的區域。
• LinearRing 邊緣長度必須小於 180 度。 將選擇兩個頂點之間的最短邊緣。
• LinearRings 不得跨邊緣且不得共用邊緣。 LinearRings 可共用頂點。

範例

下列範例會在多邊形數據列上執行地理空間聯集。

執行查詢

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)

輸出

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]]]}

下列範例會在多邊形數據行上執行地理空間聯集。

執行查詢

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)

輸出

polygons_union
{“type”：“Polygon”，“coordinates”：[[[[-73.9495,40.7969]，[-73.95807,40.80068]，[-73.9639277517478,40.792748258673875]，[-73.96888,40.79281999999992]，[-73.9662719791645,40.7895734224338]，[-73.98201,40.76825]，[-73.97317,40.76455]，[-73.960302383706178,40.782140794645024]，[-73.9577,40.7789]，[-73.94622,40.79249]，[-73.952659323173,40.792584227716468]，[-73.9495,40.7969]]}

下列範例會傳回 True，因為其中一個多邊形無效。

執行查詢

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

輸出

invalid_union
True