geo_intersects_line_with_polygon()

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

線または複数行が多角形またはマルチポリゴンと交差するかどうかを計算します。

構文

geo_intersects_line_with_polygon(lineString,polygon)

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

パラメーター

件名	タイプ	Required	説明
lineString	dynamic	✔️	GeoJSON 形式の LineString または MultiLineString。
polygon	dynamic	✔️	GeoJSON 形式の Polygon または MultiPolygon。

返品

直線または複数行がポリゴンまたはマルチポリゴンと交差するかどうかを示します。 lineStringもしくはmultiLineString、またはポリゴンもしくはマルチポリゴンが無効である場合、クエリではnull結果が生成されます。

Note

• 地理空間座標は、WGS-84 座標参照系によって表されるものとして解釈されます。
• 地球上での距離の測定に使う測地原点は、球体となっています。 線のエッジは、球体の測地線です。
• 入力線もしくはポリゴンのエッジが直線のデカルト線の場合は、平面のエッジを測地線に変換するためにgeo_line_densify()またはgeo_polygon_densify()を使用することを検討してください。

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 は頂点を共有することはできます。
• Polygon には必ずしも頂点が含まれているとは限りません。

ヒント

パフォーマンスを向上させるには、リテラル LineString または MultiLineString を使用します。

例

次の例では、リテラル 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)

出力

交差する
True

次の例では、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

出力

name
セントラルパーク・ウエスト
フレデリック･ダグラス・サークル
ウエスト110番通り
ウエストドライブ

次の例では、関心領域リテラル 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

出力

name
ニューヨーク

次の例では、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 isnull(geo_intersects_2lines(lineString, polygon))

出力

print_0
True

次の例では、ポリゴンが無効であるため、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))

出力

print_0
True