geo_intersection_2polygons()
適用於:✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel
計算兩個多邊形或多多邊形的交集。
語法
geo_intersection_2polygons(
polygon1,
多邊形1)
深入瞭解 語法慣例。
參數
姓名 | 類型 | 必要 | 描述 |
---|---|---|---|
多邊形1 | dynamic |
✔️ | GeoJSON 格式的多邊形或多多邊形。 |
polygon2 | dynamic |
✔️ | GeoJSON 格式的多邊形或多多邊形。 |
傳回
GeoJSON 格式和動態數據類型的交集。 如果 Polygon 或 MultiPolygon 無效,查詢將會產生 Null 結果。
注意
- 地理空間座標會解譯為 WGS-84 座標參考系統所代表。
- 用於地球上測量的地緣日期是球體。 多邊形邊緣是 球體上的地理區域 。
- 如果輸入多邊形邊緣是直線笛卡兒線,請考慮使用 geo_polygon_densify() 將平面邊緣轉換成地理區域。
多邊形定義和條件約束
dynamic({“type”: “Polygon”,“coordinates”: [LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N ]})
dynamic({“type”: “MultiPolygon”,“coordinates”: [[LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N ],..., [LinearRingShell, LinearRingHole_1, ..., LinearRingHole_M]]})
- LinearRingShell 是必要的,並定義為
counterclockwise
已排序的座標陣列 [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]。 只能有一個殼層。 - LinearRingHole 是選擇性的,並定義為
clockwise
已排序的座標數位列 [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]。 可以有任意數量的內環和孔。 - 線性Ring 頂點必須與至少三個座標相異。 第一個座標必須等於最後一個座標。 至少需要四個專案。
- 座標 [經度, 緯度] 必須有效。 經度必須是範圍 [-180, +180] 中的實數,而緯度必須是範圍 [-90, +90] 中的實數。
- LinearRingShell 會括住球體的大部分部分。 LinearRing 會將球體分成兩個區域。 將會選擇這兩個區域中的較小數目。
- LinearRing 邊緣長度必須小於 180 度。 將選擇兩個頂點之間的最短邊緣。
- LinearRings 不得交叉且不得共享邊緣。 LinearRings 可能會共享頂點。
- 多邊形包含其頂點。
提示
- 使用常值 Polygon 或 MultiPolygon 可能會導致更好的效能。
範例
下列範例會計算兩個多邊形之間的交集。 在此情況下,結果是多邊形。
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)
輸出
交集 |
---|
{"type": "Polygon", "coordinates": [[[-73.962105776437156,40.774591360999679],[-73.962642403166868,40.774807020251778],[-73.9631313085556,40.774578106920352],[-73.962079882621765,40.774167803982927],[-73.962105776437156,40.774591360999679]]]} |
下列範例會計算兩個多邊形之間的交集。 在此情況下,結果是一個點。
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)
輸出
交集 |
---|
{“type”: “Point”,“coordinates”: [2,45]} |
下列兩個多邊形交集是集合。
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)
輸出
交集 |
---|
{“type”: “GeometryCollection”,“geometries”: [ { “type”: “Point”, “coordinates”: [2, 45]}, { “type”: “Polygon”, “coordinates”: [[[[1.3227075526410679,45.003909145068739],[1.0404565374899824,45.004356403066552],[1.005,44.943],[1.356,44.937],[1.3227075526410679,45.003909145068739]]]}} |
下列兩個多邊形不會交集。
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)
輸出
交集 |
---|
{“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 | 交集 |
---|---|
紐約 | {“type”: “Polygon”,“coordinates”: [[[[-73.9621352680206, 40.77504528047145], [-73.9631313085556, 40.774578106920345], [-73.96207988262177,40.77416780398293],[-73.96213352680206, 40.775045280447145]]]} |
下列範例會傳回 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 |