geo_intersection_line_with_polygon()

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

多角形またはマルチポリゴンを含む線または複数線の交差を計算します。

構文

geo_intersection_line_with_polygon(lineString,polygon)

構文規則について詳しく知る。

パラメーター

返品

GeoJSON 形式および dynamic データ型の積集合。 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 座標配列には、少なくとも 2 つのエントリが含まれている必要があります。
• 座標 [経度,緯度] は有効である必要があります。経度は範囲 [-180, +180] の実数で、緯度は範囲 [-90, +90] の実数です。
• エッジの長さは 180 度未満でなければなりません。 2 つの頂点間の最短のエッジが選択されます。

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 は頂点を共有することはできます。
• ポリゴンにはその頂点が含まれています。

例

次の例では、線と多角形の交差部分を計算します。 この場合、結果は行になります。

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 intersection = geo_intersection_line_with_polygon(lineString, polygon)

出力

次の例では、線と多角形の交差部分を計算します。 この場合、結果は複数行になります。

let lineString = dynamic({"type":"LineString","coordinates":[[-110.522, 39.198],[-91.428, 40.880]]});
let polygon = dynamic({"type":"Polygon","coordinates":[[[-90.263,36.738],[-102.041,45.274],[-109.335,36.527],[-90.263,36.738]],[[-100.393,41.705],[-103.139,38.925],[-97.558,39.113],[-100.393,41.705]]]});
print intersection = geo_intersection_line_with_polygon(lineString, polygon)

出力

次の線と多角形は交差しません。

let lineString = dynamic({"type":"LineString","coordinates":[[1, 1],[2, 2]]});
let polygon = dynamic({"type":"Polygon","coordinates":[[[-73.9712905883789,40.78580561168767],[-73.98004531860352,40.775276834803655],[-73.97000312805176,40.77852663535664],[-73.9712905883789,40.78580561168767]]]});
print intersection = geo_intersection_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
| project name, intersection = geo_intersection_line_with_polygon(road, area_of_interest)
| where array_length(intersection.geometries) != 0

出力

次の例では、関心領域リテラル 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
| project name, intersection = geo_intersection_line_with_polygon(area_of_interest, county)
| where array_length(intersection.geometries) != 0

出力

次の例では、LineStringが無効であるため、nullの結果が返されます。

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 is_invalid = isnull(geo_intersection_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 is_invalid = isnull(geo_intersection_2lines(lineString, polygon))

出力