geo_line_simplify()
適用於:✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel
藉由在地球上以單一長邊緣取代幾乎直線的短邊緣,來簡化線條或多行。
語法
geo_line_simplify(
lineString,
容錯)
深入瞭解 語法慣例。
參數
姓名 | 類型 | 必要 | 描述 |
---|---|---|---|
lineString | dynamic |
✔️ | GeoJSON 格式的LineString或 MultiLineString。 |
tolerance | int、long 或 real | 定義介於任兩個頂點之間以公尺為單位的最小距離。 支援的值為 [0, ~7,800,000 公尺]。 如果未指定,則會使用預設值 10 。 |
傳回
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 度。 將選擇兩個頂點之間的最短邊緣。
範例
下列範例會移除彼此距離 10 公尺的頂點,藉此簡化線條。
let line = dynamic({"type":"LineString","coordinates":[[-73.97033169865608,40.789063020152824],[-73.97039607167244,40.78897975920816],[-73.9704617857933,40.78888837512432],[-73.97052884101868,40.7887949601531],[-73.9706052839756,40.788698498903564],[-73.97065222263336,40.78862640672032],[-73.97072866559029,40.78852791445617],[-73.97079303860664,40.788434498977836]]});
print simplified = geo_line_simplify(line, 10)
輸出
簡化 |
---|
{“type”: “LineString”, “coordinates”: [[-73.97033169865608, 40.789063020152824], [-73.9707930386064, 40.78843449897836]}} |
下列範例會簡化線條,並將結果結合至 GeoJSON 幾何集合。
NY_Manhattan_Roads
| project road = features.geometry
| project road_simplified = geo_line_simplify(road, 100)
| summarize roads_lst = make_list(road_simplified)
| project geojson = bag_pack("type", "Feature","geometry", bag_pack("type", "GeometryCollection", "geometries", roads_lst), "properties", bag_pack("name", "roads"))
輸出
geojson |
---|
{“type”: “Feature”, “geometry”: {“type”: “GeometryCollection”, “geometries”: [ ... ]}, “properties”: {“name”: “roads”}} |
下列範例會簡化行並統一結果
NY_Manhattan_Roads
| project road = features.geometry
| project road_simplified = geo_line_simplify(road, 100)
| summarize roads_lst = make_list(road_simplified)
| project roads = geo_union_lines_array(roads_lst)
輸出
道路 |
---|
{“type”: “MultiLineString”, “coordinates”: [ ... ]} |
下列範例會傳回 True,因為行無效。
print is_invalid_line = isnull(geo_line_simplify(dynamic({"type":"LineString","coordinates":[[1, 1]]})))
輸出
is_invalid_line |
---|
True |
下列範例會傳回 True,因為容錯無效。
print is_invalid_line = isnull(geo_line_simplify(dynamic({"type":"LineString","coordinates":[[1, 1],[2,2]]}), -1))
輸出
is_invalid_line |
---|
True |
下列範例會傳回 True,因為高容錯會導致小行消失。
print is_invalid_line = isnull(geo_line_simplify(dynamic({"type":"LineString","coordinates":[[1.1, 1.1],[1.2,1.2]]}), 100000))
輸出
is_invalid_line |
---|
True |