次の方法で共有

geo_polygon_perimeter()

  • [アーティクル]

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

地球の多角形またはマルチポリゴンの境界の長さを計算します。

構文

geo_polygon_perimeter(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 perimeter = geo_polygon_perimeter(central_park)

出力

境界
9930.30149604938

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

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 perimeter = geo_polygon_perimeter(polygons)

出力

境界
15943.5384578745

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

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

出力

is_invalid
True