共用方式為

geo_polygon_simplify（）

  • 發行項

藉由用地球上單一長邊緣取代幾乎直線的短邊緣鏈，簡化多邊形或多面形。

語法

geo_polygon_simplify(多邊形,容錯)

深入瞭解 語法慣例。

參數

姓名 類型​​ 必要 描述
多邊形 dynamic ✔️ GeoJSON 格式的多邊形或多多邊形。
tolerance int、long 或 real 定義原始平面邊緣與已轉換地理邊緣鏈結之間的公尺距離上限。 支援的值為 [0.1， 10000]。 如果未指定，則預設值為 10。

傳回

簡化的多邊形或 GeoJSON 格式和動態數據類型的多多邊形，且距離小於容錯的兩個頂點。 如果多邊形或容錯無效，查詢將會產生 Null 結果。

注意

多邊形定義和條件約束

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