geo_intersects_line_with_polygon()

適用於：✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel

計算線條或多行與多邊形或多行交集。

語法

geo_intersects_line_with_polygon(lineString,多邊形)

深入瞭解 語法慣例。

參數

傳回

指出線條或多行與多邊形或多行交集。 如果lineString或 multiLineString或多邊形或多多邊形無效，則查詢會產生 Null 結果。

LineString 定義和條件約束

dynamic（{“type”： “LineString”，“coordinates”： [[lng_1，lat_1]， [lng_2，lat_2]， ...， [lng_N，lat_N]}）

dynamic（{“type”： “MultiLineString”，“coordinates”： [[line_1， line_2， ...， line_N]}）

• LineString 座標數位必須至少包含兩個專案。
• 坐標 [經度， 緯度] 必須有效，其中經度是範圍 [-180， +180] 中的實數，而緯度是範圍 [-90， +90] 中的實數。
• 邊緣長度必須小於 180 度。 將選擇兩個頂點之間的最短邊緣。

多邊形定義和條件約束

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 可能會共享頂點。
• 多邊形不一定包含其頂點。

範例

下列範例會檢查常值LineString是否與Polygon交集。

let lineString = dynamic({"type":"LineString","coordinates":[[-73.985195,40.788275],[-73.974552,40.779761]]});
let polygon = dynamic({"type":"Polygon","coordinates":[[[-73.9712905883789,40.78580561168767],[-73.98004531860352,40.775276834803655],[-73.97000312805176,40.77852663535664],[-73.9712905883789,40.78580561168767]]]});
print intersects = geo_intersects_line_with_polygon(lineString, polygon)

輸出

下列範例會尋找NYC GeoJSON道路數據表中與感興趣常值多邊形區域相交的所有道路。

let area_of_interest = dynamic({"type":"Polygon","coordinates":[[[-73.95768642425537,40.80065354924362],[-73.9582872390747,40.80089719667298],[-73.95869493484497,40.80050736035672],[-73.9580512046814,40.80019873831593],[-73.95768642425537,40.80065354924362]]]});
NY_Manhattan_Roads
| project name = features.properties.Label, road = features.geometry
| where geo_intersects_line_with_polygon(road, area_of_interest)
| project name

輸出

下列範例會尋找與相關常值LineString區域相交的美國所有縣。

let area_of_interest = dynamic({"type":"LineString","coordinates":[[-73.97159099578857,40.794513338780895],[-73.96738529205322,40.792758888618756],[-73.96978855133057,40.789769718601505]]});
US_Counties
| project name = features.properties.NAME, county = features.geometry
| where geo_intersects_line_with_polygon(area_of_interest, county)
| project name

輸出

下列範例會傳回 Null 結果，因為 LineString 無效。

let lineString = dynamic({"type":"LineString","coordinates":[[-73.985195,40.788275]]});
let polygon = dynamic({"type":"Polygon","coordinates":[[[-73.95768642425537,40.80065354924362],[-73.9582872390747,40.80089719667298],[-73.95869493484497,40.80050736035672],[-73.9580512046814,40.80019873831593],[-73.95768642425537,40.80065354924362]]]});
print isnull(geo_intersects_2lines(lineString, polygon))

輸出

下列範例會傳回 Null 結果，因為多邊形無效。

let lineString = dynamic({"type":"LineString","coordinates":[[-73.97159099578857,40.794513338780895],[-73.96738529205322,40.792758888618756],[-73.96978855133057,40.789769718601505]]});
let polygon = dynamic({"type":"Polygon","coordinates":[]});
print isnull(geo_intersects_2lines(lineString, polygon))

輸出