geo_intersection_2polygons()
適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー✅Azure Monitor✅Microsoft Sentinel
2 つのポリゴンまたはマルチポリゴンの交差を計算します。
構文
geo_intersection_2polygons(polygon1,polygon2)
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| polygon1 | dynamic |
✔️ | GeoJSON 形式の多角形またはマルチポリゴン。 |
| polygon2 | dynamic |
✔️ | GeoJSON 形式の多角形またはマルチポリゴン。 |
返品
GeoJSON 形式および dynamic データ型の積集合。 ポリゴンまたはマルチポリゴンが無効な場合、クエリで 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 は頂点を共有することはできます。
- ポリゴンにはその頂点が含まれています。
ヒント
- リテラル ポリゴンまたは マルチポリゴンを使用すると、パフォーマンスが向上する可能性があります。
例
次の例では、2 つのポリゴン間の交差を計算します。 この場合、結果は多角形になります。
let polygon1 = dynamic({"type":"Polygon","coordinates":[[[-73.9630937576294,40.77498840732385],[-73.963565826416,40.774383111780914],[-73.96205306053162,40.773745311181585],[-73.96160781383514,40.7743912365898],[-73.9630937576294,40.77498840732385]]]});
let polygon2 = dynamic({"type":"Polygon","coordinates":[[[-73.96213352680206,40.775045280447145],[-73.9631313085556,40.774578106920345],[-73.96207988262177,40.77416780398293],[-73.96213352680206,40.775045280447145]]]});
print intersection = geo_intersection_2polygons(polygon1, polygon2)
出力
| intersection |
|---|
| {"type": "Polygon", "coordinates": [[[-73.962105776437156,40.774591360999679],[-73.962642403166868,40.774807020251778],[-73.9631313085556,40.774578106920352],[-73.962079882621765,40.774167803982927],[-73.962105776437156,40.774591360999679]]]} |
次の例では、2 つのポリゴン間の交差を計算します。 この場合、結果はポイントです。
let polygon1 = dynamic({"type":"Polygon","coordinates":[[[2,45],[0,45],[1,44],[2,45]]]});
let polygon2 = dynamic({"type":"Polygon","coordinates":[[[3,44],[2,45],[2,43],[3,44]]]});
print intersection = geo_intersection_2polygons(polygon1, polygon2)
出力
| intersection |
|---|
| {"type": "Point","coordinates": [2,45]} |
次の 2 つの多角形の交差部分はコレクションです。
let polygon1 = dynamic({"type":"Polygon","coordinates":[[[2,45],[0,45],[1,44],[2,45]]]});
let polygon2 = dynamic({"type":"MultiPolygon","coordinates":[[[[3,44],[2,45],[2,43],[3,44]]],[[[1.192,45.265],[1.005,44.943],[1.356,44.937],[1.192,45.265]]]]});
print intersection = geo_intersection_2polygons(polygon1, polygon2)
出力
| intersection |
|---|
| {"type": "GeometryCollection","geometries": [ { "type": "Point", "coordinates": [2, 45]}, { "type": "Polygon", "coordinates": [[[1.3227075526410679,45.003909145068739],[1.0404565374899824,45.0043564030665 [52],[1.005,44.943],[1.356,44.937],[1.3227075526410679,45.003909145068739]]}]} |
次の 2 つのポリゴンは交差しません。
let polygon1 = dynamic({"type":"Polygon","coordinates":[[[2,45],[0,45],[1,44],[2,45]]]});
let polygon2 = dynamic({"type":"Polygon","coordinates":[[[3,44],[3,45],[2,43],[3,44]]]});
print intersection = geo_intersection_2polygons(polygon1, polygon2)
出力
| intersection |
|---|
| {"type": "GeometryCollection", "geometries": []} |
次の例では、関心のあるポリゴンの領域と交差する米国内のすべての郡を検索します。
let area_of_interest = dynamic({"type":"Polygon","coordinates":[[[-73.96213352680206,40.775045280447145],[-73.9631313085556,40.774578106920345],[-73.96207988262177,40.77416780398293],[-73.96213352680206,40.775045280447145]]]});
US_Counties
| project name = features.properties.NAME, county = features.geometry
| project name, intersection = geo_intersection_2polygons(county, area_of_interest)
| where array_length(intersection.geometries) != 0
出力
| name | intersection |
|---|---|
| ニューヨーク | {"type": "Polygon","coordinates": [[[-73.9621352680206, 40.775045280447145], [-73.9631313085556, 40.774578106920345], [-73.96207988262177,40.77416780398293],[-73.96213352680206, 40.775045280447145]] } |
次の例では、ポリゴンの 1 つが無効であるため、null 値の結果が返されます。
let central_park_polygon = dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807266235352,40.80068603561921],[-73.98201942443848,40.76825672305777],[-73.97317886352539,40.76455136505513],[-73.9495,40.7969]]]});
let invalid_polygon = dynamic({"type":"Polygon"});
print isnull(geo_intersection_2polygons(invalid_polygon, central_park_polygon))
出力
| print_0 |
|---|
| 1 |