geo_polygon_simplify ()

  • 發行項

使用地球上的單一長邊緣來取代幾乎直線的短邊緣，以簡化多邊形或多多邊形。

語法

geo_polygon_simplify(polygon,tolerance)

深入瞭解 語法慣例。

參數

名稱 類型 必要 Description
多邊形 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 是必要條件，且會定義為座標[[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]] 的 counterclockwise 已排序陣列。 只能有一個殼層。
  • LinearRingHole 是選擇性條件，且會定義為座標 [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]] 的 clockwise 已排序陣列。 可以有任意數目的內部通道和漏洞。
  • LinearRing 頂點必須與至少三個座標不同。 第一個座標必須等於最後一個座標。 至少需要四個輸入項。
  • 坐標 [經度，緯度] 必須有效。 經度必須是範圍 [-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.796734763556572]，[-73.94906312272477， 40.797107362717881]，[-73.949236124753952， 40.7968708081794]，[-73.948851227760315， 40.79673476356572]]]}

下列範例會簡化多邊形，並將結果合併成 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