geo_line_length()
適用於:✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel
計算地球上線條或多行的總長度。
語法
geo_line_length(
lineString)
深入瞭解 語法慣例。
參數
姓名 | 類型 | 必要 | 描述 |
---|---|---|---|
lineString | dynamic |
✔️ | GeoJSON 格式的LineString或 MultiLineString。 |
傳回
地球上線條或多行的總長度,以公尺為單位。 如果行或多行無效,查詢將會產生 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 度。 將選擇兩個頂點之間的最短邊緣。
範例
下列範例會計算總行長度,以公尺為單位。
let line = dynamic({"type":"LineString","coordinates":[[-73.95807266235352,40.800426144169315],[-73.94966125488281,40.79691751000055],[-73.97317886352539,40.764486356930334]]});
print length = geo_line_length(line)
輸出
length |
---|
4922.48016992081 |
下列範例會以公尺為單位計算多行長度總計。
let line = dynamic({"type":"MultiLineString","coordinates":[[[-73.95798683166502,40.800556090021466],[-73.98193359375,40.76819171855746]],[[-73.94940376281738,40.79691751000055],[-73.97317886352539,40.76435634049001]]]});
print length = geo_line_length(line)
輸出
length |
---|
8262.24339753741 |
下列範例會傳回 True,因為行無效。
print is_bad_line = isnull(geo_line_length(dynamic({"type":"LineString","coordinates":[[1, 1]]})))
輸出
is_bad_line |
---|
True |