geo_line_buffer ()
計算多邊形或多多邊形,其中包含地球輸入線或多線指定半徑內的所有點。
Syntax
geo_line_buffer(
lineString,
半徑,
寬容)
深入瞭解 語法慣例。
參數
名稱 | 類型 | 必要 | Description |
---|---|---|---|
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,因為半徑無效。
print buffer = isnull(geo_line_buffer(dynamic({"type":"LineString","coordinates":[[0,0],[1,1]]}), 0))
緩衝區 |
---|
True |
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應