geo_line_buffer()
適用於：✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel
計算多邊形或多邊形，其中包含地球上輸入線或多行指定半徑內的所有點。
語法
geo_line_buffer(lineString, 半徑,容錯)
深入瞭解 語法慣例。
參數
| 姓名 | 類型 | 必要 | 描述 |
|---|---|---|---|
| lineString | dynamic |
✔️ | GeoJSON 格式的LineString或 MultiLineString。 |
| 半徑 | real |
✔️ | 以公尺為單位的緩衝區半徑。 有效值必須是正數。 |
| tolerance | real |
定義以公尺為單位的容錯，以決定多邊形可以偏離理想半徑多少。 如果未指定，則會使用預設值 10 。 容錯應不低於半徑的0.0001%。 指定大於半徑的容錯，會將容錯降低到半徑下方的最大可能值。 |
傳回
輸入 LineString 或 MultiLineString 周圍的多邊形或 MultiPolygon。 如果座標或半徑或容錯無效，查詢會產生 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 度。 將選擇兩個頂點之間的最短邊緣。
範例
下列查詢會計算線條周圍的多邊形，半徑為4公尺和0.1公尺容錯
let line = dynamic({"type":"LineString","coordinates":[[-80.66634997047466,24.894526340592122],[-80.67373241820246,24.890808090321286]]});
print buffer = geo_line_buffer(line, 4, 0.1)
| 緩衝區 |
|---|
| {“type”： “Polygon”， “coordinates”： [ ... ]} |
下列查詢會計算每個行周圍的緩衝區，並統一結果
datatable(line:dynamic)
[
dynamic({"type":"LineString","coordinates":[[14.429214068940496,50.10043066548272],[14.431184174126173,50.10046525983731]]}),
dynamic({"type":"LineString","coordinates":[[14.43030222687753,50.100780677801936],[14.4303847111523,50.10020274910934]]})
]
| project buffer = geo_line_buffer(line, 2, 0.1)
| summarize polygons = make_list(buffer)
| project result = geo_union_polygons_array(polygons)
| result |
|---|
| {“type”： “Polygon”，“coordinates”： [ ... ]} |
下列範例會傳回 true，因為行無效。
print buffer = isnull(geo_line_buffer(dynamic({"type":"LineString"}), 5))
| 緩衝區 |
|---|
| True |
下列範例會傳回 true，因為半徑無效。
print buffer = isnull(geo_line_buffer(dynamic({"type":"LineString","coordinates":[[0,0],[1,1]]}), 0))
| 緩衝區 |
|---|
| True |