geo_polygon_simplify()
適用於：✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel
藉由用地球上單一長邊緣取代幾乎直線的短邊緣鏈，簡化多邊形或多面形。
語法
geo_polygon_simplify(多邊形,容錯)
深入瞭解 語法慣例。
參數
| 姓名 | 類型 | 必要 | 描述 |
|---|---|---|---|
| 多邊形 | dynamic |
✔️ | GeoJSON 格式的多邊形或多多邊形。 |
| tolerance | int、long 或 real | 定義原始平面邊緣與已轉換地理邊緣鏈結之間的公尺距離上限。 支援的值為 [0.1， 10000]。 如果未指定，則預設值為 10。 |
傳回
簡化的多邊形或 GeoJSON 格式和動態數據類型的多多邊形，且距離小於容錯的兩個頂點。 如果多邊形或容錯無效，查詢將會產生 Null 結果。
注意
- 如果輸入有多個多邊形，且具有相互框線，請參閱 geo_simplify_polygons_array（）。
- 地理空間座標會解譯為 WGS-84 座標參考系統所代表。
- 用於地球上測量的地緣日期是球體。 多邊形邊緣是 球體上的地理區域 。
- 如果輸入多邊形邊緣是直線笛卡兒線，請考慮使用 geo_polygon_densify（） 將平面邊緣轉換成地理區域。
- 如果輸入是多多邊形，且包含多個多邊形，則結果會是多邊形聯集的區域。
- 高容錯可能會導致小型多邊形消失。
多邊形定義和條件約束
dynamic（{“type”： “Polygon”，“coordinates”： [ LinearRingShell， LinearRingHole_1， ...， LinearRingHole_N ]}）
dynamic（{“type”： “MultiPolygon”，“coordinates”： [[ LinearRingShell， LinearRingHole_1， ...， LinearRingHole_N ]， ...， [LinearRingShell， LinearRingHole_1， ...， LinearRingHole_M]}）
- LinearRingShell 是必要的，並定義為
counterclockwise已排序的座標陣列 [[lng_1，lat_1],...,[lng_i，lat_i],...,[lng_j，lat_j],...,[lng_1，lat_1]]。 只能有一個殼層。 - LinearRingHole 是選擇性的，並定義為
clockwise已排序的座標數位列 [[lng_1，lat_1],...,[lng_i，lat_i],...,[lng_j，lat_j],...,[lng_1，lat_1]]。 可以有任意數量的內環和孔。 - 線性Ring 頂點必須與至少三個座標相異。 第一個座標必須等於最後一個座標。 至少需要四個專案。
- 座標 [經度， 緯度] 必須有效。 經度必須是範圍 [-180， +180] 中的實數，而緯度必須是範圍 [-90， +90] 中的實數。
- LinearRingShell 會括住球體的大部分部分。 LinearRing 會將球體分成兩個區域。 將會選擇這兩個區域中的較小數目。
- LinearRing 邊緣長度必須小於 180 度。 將選擇兩個頂點之間的最短邊緣。
- LinearRings 不得交叉且不得共享邊緣。 LinearRings 可能會共享頂點。
範例
下列範例會移除彼此距離 10 公尺的頂點，藉此簡化多邊形。
let polygon = dynamic({"type":"Polygon","coordinates":[[[-73.94885122776031,40.79673476355657],[-73.94885927438736,40.79692258628347],[-73.94887939095497,40.79692055577034],[-73.9488673210144,40.79693476936093],[-73.94888743758202,40.79693476936093],[-73.9488834142685,40.796959135509105],[-73.94890084862709,40.79695304397289],[-73.94906312227248,40.79710736271788],[-73.94923612475395,40.7968708081794],[-73.94885122776031,40.79673476355657]]]});
print simplified = geo_polygon_simplify(polygon)
輸出
| 簡化 |
|---|
| {“type”： “Polygon”， “coordinates”： [[[-73.948851227760315， 40.79673476376572]，[-73.94906312272477， 40.797107362717881]，[-73.949236124753952,40.7968708081794]，[-73.948851227760315， 40.79673476376356572]]]} |
下列範例會簡化多邊形，並將結果結合至 GeoJSON 幾何集合。
Polygons
| project polygon = features.geometry
| project simplified = geo_polygon_simplify(polygon, 1000)
| summarize lst = make_list(simplified)
| project geojson = bag_pack("type", "Feature","geometry", bag_pack("type", "GeometryCollection", "geometries", lst), "properties", bag_pack("name", "polygons"))
輸出
| geojson |
|---|
| {“type”： “Feature”， “geometry”： {“type”： “GeometryCollection”， “geometries”： [ ... ]}， “properties”： {“name”： “polygons”}} |
下列範例會簡化多邊形並統一結果
US_States
| project polygon = features.geometry
| project simplified = geo_polygon_simplify(polygon, 1000)
| summarize lst = make_list(simplified)
| project polygons = geo_union_polygons_array(lst)
輸出
| 多邊形 |
|---|
| {“type”： “MultiPolygon”， “coordinates”： [ ... ]} |
下列範例會傳回 True，因為多邊形無效。
let polygon = dynamic({"type":"Polygon","coordinates":[[[5,48],[5,48]]]});
print is_invalid_polygon = isnull(geo_polygon_simplify(polygon))
輸出
| is_invalid_polygon |
|---|
| 1 |
下列範例會傳回 True，因為容錯無效。
let polygon = dynamic({"type":"Polygon","coordinates":[[[5,48],[0,50],[0,47],[4,47],[5,48]]]});
print is_invalid_polygon = isnull(geo_polygon_simplify(polygon, -0.1))
輸出
| is_invalid_polygon |
|---|
| 1 |
下列範例會傳回 True，因為高容錯會導致多邊形消失。
let polygon = dynamic({"type":"Polygon","coordinates":[[[5,48],[0,50],[0,47],[4,47],[5,48]]]});
print is_invalid_polygon = isnull(geo_polygon_simplify(polygon, 1000000))
輸出
| is_invalid_polygon |
|---|
| 1 |