geo_polygon_centroid()

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

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

構文

geo_polygon_centroid(polygon)

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

パラメーター

返品

GeoJSON 形式で、動的データ型の重心座標値。 多角形またはマルチポリゴンが無効な場合、クエリは 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 は交差させることはできず、エッジを共有することはできません。 LinearRings は頂点を共有する場合があります。

例

次の例では、ニューヨーク市のセントラル パーク重心を計算します。

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 centroid = geo_polygon_centroid(central_park)

出力

次の例では、中央公園の重心経度を計算します。

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 
centroid = geo_polygon_centroid(central_park)
| project lng = centroid.coordinates[0]

出力

次の例では、マルチポリゴンでポリゴンの和集合を実行し、統合ポリゴンの重心を計算します。

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_centroid = geo_polygon_centroid(polygons)

出力

次の例では、中央公園の重心をマップ上に視覚化します。

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 
centroid = geo_polygon_centroid(central_park)
| render scatterchart with (kind = map)

出力

次の例では、無効な多角形が原因で true が返されます。

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

出力