geo_union_lines_array ()

計算地球線條或多行的聯集。

Syntax

geo_union_lines_array(lineStrings)

深入瞭解 語法慣例

參數

名稱 類型 必要 Description
lineStrings dynamic ✔️ GeoJSON 格式的線條或多行陣列。

傳回

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

注意

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

LineString 定義和限制

dynamic ({“type”: “LineString”,“coordinates”: [[lng_1,lat_1], [lng_2,lat_2], ..., [lng_N,lat_N]})

dynamic ({“type”: “MultiLineString”,“coordinates”: [[line_1, line_2, ..., line_N]]})

  • LineString 座標陣列必須包含至少兩個項目。
  • 坐標 [經度, 緯度] 必須是有效的,其中經度是範圍 [-180, +180] 中的實數,而緯度是範圍 [-90, +90] 中的實數。
  • 邊緣長度必須小於 180 度。 將選擇兩個頂點之間的最短邊緣。

範例

下列範例會在行列上執行地理空間聯集。

datatable(lines:dynamic)
[
    dynamic({"type":"LineString","coordinates":[[-73.95683884620665,40.80502891480884],[-73.95633727312088,40.8057171711177],[-73.95489156246185,40.80510200431311]]}),
    dynamic({"type":"LineString","coordinates":[[-73.95633727312088,40.8057171711177],[-73.95489156246185,40.80510200431311],[-73.95537436008453,40.804413741624515]]}),
    dynamic({"type":"LineString","coordinates":[[-73.95633727312088,40.8057171711177],[-73.95489156246185,40.80510200431311]]})
]
| summarize lines_arr = make_list(lines)
| project lines_union = geo_union_lines_array(lines_arr)

輸出

lines_union
{“type”: “LineString”, “coordinates”: [[-73.956838846206651, 40.805028914808844], [-73.956337312088, 40.8057171711177], [ -73.954891562461853, 40.80510200431312], [-73.955374360084534, 40.804413741624522]]}

下列範例會在行欄上執行地理空間聯集。

datatable(line1:dynamic, line2:dynamic)
[
    dynamic({"type":"LineString","coordinates":[[-73.95683884620665,40.80502891480884],[-73.95633727312088,40.8057171711177],[-73.95489156246185,40.80510200431311]]}), dynamic({"type":"LineString","coordinates":[[-73.95633727312088,40.8057171711177],[-73.95489156246185,40.80510200431311],[-73.95537436008453,40.804413741624515]]})
]
| project lines_arr = pack_array(line1, line2)
| project lines_union = geo_union_lines_array(lines_arr)

輸出

lines_union
{“type”: “LineString”, “coordinates”:[[-73.956838846206651, 40.805028914808844], [-73.95633727312088, 40.8057171711177], [-73.954891562461853, 40.80510200431312], [-73.955374360084534, 40.804413741624522]]}

下列範例會傳回 True,因為其中一行無效。

datatable(lines:dynamic)
[
    dynamic({"type":"LineString","coordinates":[[-73.95683884620665,40.80502891480884],[-73.95633727312088,40.8057171711177],[-73.95489156246185,40.80510200431311]]}),
    dynamic({"type":"LineString","coordinates":[[1, 1]]})
]
| summarize lines_arr = make_list(lines)
| project invalid_union = isnull(geo_union_lines_array(lines_arr))

輸出

invalid_union
True