geo_polygon_buffer()
適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー✅Azure Monitor✅Microsoft Sentinel
入力ポリゴンまたは地球上のマルチポリゴンの指定された半径内のすべてのポイントを含むポリゴンまたはマルチポリゴンを計算します。
構文
geo_polygon_buffer(polygon, radius, tolerance)
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| polygon | dynamic |
✔️ | GeoJSON 形式の多角形またはマルチポリゴン。 |
| 半径 | real |
✔️ | バッファーの半径 (メートル単位)。 有効な値は正の整数で指定する必要があります。 |
| tolerance | real |
ポリゴンが理想的な半径からどの程度逸脱できるかを決定する許容範囲をメートル単位で定義します。 指定されない場合は、既定値の 10 が使用されます。 許容範囲は半径の 0.0001% 以下にする必要があります。 半径より大きい許容値を指定すると、許容範囲が半径より小さい最大の値に下がります。 |
返品
入力ポリゴンまたはマルチポリゴンの周囲の多角形または MultiPolygon。 座標または半径または許容値が無効な場合、クエリによって 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 は頂点を共有することはできます。
- ポリゴンにはその頂点が含まれています。
例
次のクエリでは、半径が 10 km の入力ポリゴンの周りの多角形を計算します。
let polygon = dynamic({"type":"Polygon","coordinates":[[[139.813757,35.719666],[139.72558,35.71813],[139.727471,35.653231],[139.818721,35.657264],[139.813757,35.719666]]]});
print buffer = geo_polygon_buffer(polygon, 10000)
| buffer |
|---|
| {"type": "Polygon","coordinates": [ ... ]} |
次のクエリでは、各ポリゴンの周囲のバッファーを計算し、結果を統一します
datatable(polygon:dynamic, radius:real )
[
dynamic({"type":"Polygon","coordinates":[[[12.451218693639277,41.906457003556625],[12.445753852969375,41.90160968881543],[12.453514425793855,41.90361551885886],[12.451218693639277,41.906457003556625]]]}), 100,
dynamic({"type":"Polygon","coordinates":[[[12.4566086734784,41.905119850039995],[12.453913683559591,41.903652663265234],[12.455485761012113,41.90146110630562],[12.4566086734784,41.905119850039995]]]}), 20
]
| project buffer = geo_polygon_buffer(polygon, radius)
| summarize polygons = make_list(buffer)
| project result = geo_union_polygons_array(polygons)
| 結果 |
|---|
| {"type": "Polygon","coordinates": [ ... ]} |
次の例では、無効な多角形が原因で true が返されます。
print buffer = isnull(geo_polygon_buffer(dynamic({"type":"p"}), 1))
| buffer |
|---|
| True |
次の例では、半径が無効なため true を返します。
print buffer = isnull(geo_polygon_buffer(dynamic({"type":"Polygon","coordinates":[[[10,10],[0,10],[0,0],[10,10]]]}), 0))
| buffer |
|---|
| True |