次の方法で共有

geo_simplify_polygons_array()

  • [アーティクル]

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

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

構文

geo_simplify_polygons_array(polygons, tolerance)

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

パラメーター

件名 タイプ Required 説明
polygon dynamic ✔️ GeoJSON 形式の多角形またはマルチポリゴン。
tolerance int、long、または real 任意の 2 つの頂点間の最小距離をメートル単位で定義します。 サポートされる値の範囲は [0, ~7,800,000 メートル] です。 指定されない場合は、既定値の 10 が使用されます。

返品

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

Note

  • 入力が 1 つの多角形の場合は、 geo_polygon_simplify()を参照してください。
  • 地理空間座標は、WGS-84 座標参照系によって表されるものとして解釈されます。
  • 地球上の測定に使用される測地原点は球体です。 ポリゴンのエッジは、球体の測地線です。
  • 入力ポリゴンのエッジが直交直線の場合は、geo_polygon_densify() を使用して平面のエッジを測地線に変換することを検討してください。
  • 入力がマルチポリゴンで、複数のポリゴンが含まれている場合、結果はポリゴンの和集合の面積になります。
  • 許容範囲が大きいと、小さな多角形が消える可能性があります。

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 は頂点を共有することはできます。

例

次の例では、互いに 100 メートルの距離内にある頂点を削除することで、相互境界線 (米国の州) を持つ多角形を簡略化します。

US_States
| project polygon = features.geometry
| summarize lst = make_list(polygon)
| project polygons = geo_simplify_polygons_array(lst, 100)

出力

ポリゴン
{ "type": "MultiPolygon", "coordinates": [ ... ]]}

次の例では、ポリゴンの 1 つが無効であるため、True を返します。

datatable(polygons:dynamic)
[
    dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807,40.80068],[-73.98201,40.76825],[-73.97317,40.76455],[-73.9495,40.7969]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.94622,40.79249]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.97335,40.77274],[-73.9936,40.76630],[-73.97171,40.75655],[-73.97335,40.77274]]]})
]
| summarize arr = make_list(polygons)
| project is_invalid_polygon = isnull(geo_simplify_polygons_array(arr))

出力

is_invalid_polygon
1

次の例では、無効な許容範囲のため True を返します。

datatable(polygons:dynamic)
[
    dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807,40.80068],[-73.98201,40.76825],[-73.97317,40.76455],[-73.9495,40.7969]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.94622,40.79249],[-73.96888,40.79282],[-73.9577,40.7789],[-73.94622,40.79249]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.97335,40.77274],[-73.9936,40.76630],[-73.97171,40.75655],[-73.97335,40.77274]]]})
]
| summarize arr = make_list(polygons)
| project is_null = isnull(geo_simplify_polygons_array(arr, -1))

出力

is_null
1

次の使用例は True を返します。許容度が高い場合、多角形が消えます。

datatable(polygons:dynamic)
[
    dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807,40.80068],[-73.98201,40.76825],[-73.97317,40.76455],[-73.9495,40.7969]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.94622,40.79249],[-73.96888,40.79282],[-73.9577,40.7789],[-73.94622,40.79249]]]}),
    dynamic({"type":"Polygon","coordinates":[[[-73.97335,40.77274],[-73.9936,40.76630],[-73.97171,40.75655],[-73.97335,40.77274]]]})
]
| summarize arr = make_list(polygons)
| project is_null = isnull(geo_simplify_polygons_array(arr, 10000))

出力

is_null
1