geo_polygon_simplify()

適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー✅Azure Monitor✅Microsoft Sentinel

短いエッジのほぼ直線状のチェーンを地球上の単一の長いエッジに置き換えることで、多角形またはマルチポリゴンを簡略化します。

構文

geo_polygon_simplify(polygon, tolerance)

構文規則について詳しく知る。

パラメーター

返品

GeoJSON 形式の簡略化された多角形またはマルチポリゴンおよびdynamic データ型で、距離が許容値より小さい 2 つの頂点がありません。 Polygonまたはtoleranceが無効な場合、クエリはnullの結果を生成します。

Polygon の定義と制約

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 で順序付けされた配列として定義されます。 シェルは 1 つしか使用できません。
• LinearRingHole は省略可能で、座標 [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]] のclockwise で順序付けされた配列として定義されます。 任意の数の内部リングとホールを使用できます。
• LinearRing 頂点は、少なくとも 3 つの座標が異なる必要があります。 最初の座標は、最後の座標と等しくなければなりません。 少なくとも 4 つのエントリが必要です。
• 座標 [経度,緯度] が有効である必要があります。 経度は[-180, + 180]の範囲の実数である必要があり、緯度は[-90, + 90]の範囲の実数である必要があります。
• LinearRingShell は最大で球の半分を囲みます。 LinearRingは球を2つのリージョンに分割します。 2つのリージョン*のうち、小さい方が選択されます。
• LinearRing のエッジの長さは 180 度未満である必要があります。 2 つの頂点間の最短のエッジが選択されます。
• LinearRing は交差させることはできず、エッジを共有することはできません。 LinearRing は頂点を共有することはできます。

例

次の例では、互いに 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)

出力

次の例では、多角形を簡略化し、結果を 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"))

出力

次の例では、多角形を簡略化し、結果を統一します

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)

出力

次の例では、無効なポリゴンが原因で、True が返されます。

let polygon = dynamic({"type":"Polygon","coordinates":[[[5,48],[5,48]]]});
print is_invalid_polygon = isnull(geo_polygon_simplify(polygon))

出力

次の例では、無効な許容範囲のため 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))

出力

次の使用例は 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))

出力