geo_polygon_area()

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

地球上の多角形またはマルチポリゴンの面積を計算します。

構文

geo_polygon_area(polygon)

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

パラメーター

件名	タイプ	Required	説明
polygon	dynamic	✔️	GeoJSON 形式の多角形またはマルチポリゴン。

返品

地球上のポリゴンまたはマルチポリゴンの面積 (平方メートル単位)。 多角形またはマルチポリゴンが無効な場合、クエリによって null 結果が生成されます。

Note

• 地理空間座標は、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 は頂点を共有することはできます。

例

次の例では、NYC セントラル パークの面積を計算します。

クエリを実行する

let central_park = dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807266235352,40.80068603561921],[-73.98201942443848,40.76825672305777],[-73.97317886352539,40.76455136505513],[-73.9495,40.7969]]]});
print area = geo_polygon_area(central_park)

出力

area
3475207.28346606

次の例では、マルチポリゴンのポリゴンの和集合を実行し、統合されたポリゴンの面積を計算します。

クエリを実行する

let polygons = dynamic({"type":"MultiPolygon","coordinates":[[[[-73.9495,40.7969],[-73.95807266235352,40.80068603561921],[-73.98201942443848,40.76825672305777],[-73.97317886352539,40.76455136505513],[-73.9495,40.7969]]],[[[-73.94262313842773,40.775991804565585],[-73.98107528686523,40.791849155467695],[-73.99600982666016,40.77092185281977],[-73.96150588989258,40.75609977566361],[-73.94262313842773,40.775991804565585]]]]});
print polygons_union_area = geo_polygon_area(polygons)

出力

polygons_union_area
10889971.5343487

次の例では、米国の州の面積上位 5 位を算出します。

クエリを実行する

US_States
| project name = features.properties.NAME, polygon = geo_polygon_densify(features.geometry)
| project name, area = geo_polygon_area(polygon)
| top 5 by area desc

出力

name	area
アラスカ	1550934810070.61
テキサス	693231378868.483
カリフォルニア	410339536449.521
モンタナ	379583933973.436
ニューメキシコ	314979912310.579

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

クエリを実行する

print isnull(geo_polygon_area(dynamic({"type": "Polygon","coordinates": [[[0,0],[10,10],[10,10],[0,0]]]})))

出力

print_0
True